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Make something amazing with 
these inspirational builds 
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CanaKit Raspberry Pi 3 Ultimate Starter Kit 
Model B | 1 GB RAM | 1.2 GHz | Quad-Core CPU 


> Learn to Code 
> Explore Computing 
> Get started with Electronics 


KiT INCLUDES RASPBERRY P13 AND... 
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PUSH-BUTTONS 


FULL-SIZE 
BREADBOARD 


GP1O To BREADBOARD 


JUMPERS 
INTERFACE BOARD 


MALE TO MALE & 
MALE TO FEMALE 


Available for worldwide shipping at: 


WWW.CANAKIT.COM 
Raspberry Pi Zero W 


Now available at CanaKit! 
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WELCOME 
to issue 75 


We often say it, but The MagPi is acommunity magazine. 
Many articles are written by the Raspberry Pi community; 
all our amazing projects are built by the community, 

and every penny we make is ploughed back into ensuring 

The Raspberry Pi Foundation can train the next generation of 

Raspberry Pi makers. 

We truly couldn’t make this magazine without the Raspberry 
Pi community. You are stars, each and every one of you. 

In honour of this massive milestone, we have been working 
with the community to choose the 75 Greatest Raspberry Pi 
projects (page 14). 

It’s an absolute honour to edit The MagPi, but we really 
couldn’t do it without our readers. So let’s all raise a glass to 
issue 75, and look forward to many more issues to come. 


T hank you so much for helping us get all the way to issue 75. 


Lucy Hattersley Editor 
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Lucy 
Hattersley 


Editor of The MagPi. 
Lucy codes, crafts, 
and creates wonky 
robots. She speaks 
French (badly) and 
mangles the piano. 
One day she'll get 
that pet dog. 
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DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While 
we attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations 
covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible for understanding the requirements in your 
jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go 
beyond. It is your responsibility to understand the manufacturer's limits. 
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Coolest 
Projects 2019 


A showcase for young innovators, 
Coolest Projects is simply inspirational, 
Rosie Hattersley reports 


ack in 2012, when Raspberry Pi was merely 

a great new idea garnering lots of positive 

praise, another excellent innovation 
aimed at inspiring young creators was also in | Me 
its infancy. ti | as 

Coolest Projects (coolestprojects.org) began | 

in Ireland as a Science fair and forum for like- 
minded inventors to meet and show off their 
ideas. Founded by CoderDojo volunteers Noel 
King and Ben Chapman, the event has gone from 
strength to strength, with thousands of young 
scientists and technologists attending Dublin’s 
annual Coolest Projects showcase each year. 


The event Is not just about 
the creativity, innovation, 
and sheer effort that 
everyone puts In, but the 
sense of community 


This year, Coolest Projects came under the 
wing of The Raspberry Pi Foundation, with 
events in Ireland, the UK, and North America. : 

These locations will be hosting Coolest During Coolest Projects, 
Projects fairs again in 2019, according to The eo er, 


: : ae : amazing projects that 
Raspberry Pi Foundation CEO Philip Colligan. they've built 
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A The Raspberry Pi 
Foundation CEO Philip 
Colligan taking lessons 
from his son, Dylan 


Coolest Projects North America will be held 
at The Discovery Cube, Orange County on 
Saturday 23 March, while RDS in Dublin takes a 
turn to host on Saturday 5 May. Ahead of both 
these showcases will be the UK event, now in 
Manchester at The Sharp Project on 2 March. 

Philip says, “Coolest Projects is where 
thousands of young people showcase amazing 
projects that they’ve built using digital 
technologies. If you want to meet the innovators 
of the future, this is the place to be.” 

For him, the event is not just about the 
creativity, innovation, and sheer effort that 
everyone puts in, but the sense of community. 
If that doesn’t sound like the sort of event a 
Raspberry Pi fan might be involved with, we’re 
not sure what does. 

Registration for all three events opens in 
January. Milan, Belgium, and Bulgaria will also be 
holding community events that will run roughly 
concurrently with the Coolest Projects science 
fairs next spring. Hi 


A Coolest Projects enables 
children to get hands-on 
with the latest technology 
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4D Arcade Machine: 
Cant Drive This B= 


A Raspberry Pi-powered arcade display with hidden 
interactive controls won over the crowds at Gamescom., 
Rosie Hattersley and Rob Zwetsloot got the inside scoop 


f you’re going to add a little something extra to 
wow the crowd at the Gamescom video games 
trade fair, a Raspberry Pi is a surefire way of 
getting you noticed. And that’s the way Pixel Maniacs 
went about it. 

The Nuremberg-based games developer retrofitted 
an arcade machine with a Raspberry Pi to showcase its 
intentionally silly Can’t Drive This precarious driving 
Pixel Maniacs game (magpi.cc/TphZao) at Gamescom. 

Complete with wrecking balls, explosions, an 
inconvenient number of walls, and the jeopardy 


Machine creator Pixel 
Maniacs usually makes 
PC and console games 


Pixel Maniacs is a 
Nuremberg-based 


games maker that of having to construct your road as you negotiate 
started out making your way, at speed, across an ocean to the relative 
Luge ecea ae safety of the next lump of land, Can’t Drive This 
days it specialises ; ; 

PC, Xbox One, 

PlayStation, and Splash action 

Nintendo Switch. : . ; 

Jour Cant Dive Pixel Maniacs then took things up a notch by 

This is its first foray providing interactive elements, building a mock 
into gaming with a 4D arcade game (so-named because they feature 


Raspberry Pi. 


pixel-maniacs.com 


> This two-player 
co-operative game 


involves one player | i! } i fi ® | 
building the track while i i} he | 
the other drives along it | biti} ti jim) 2 
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A Raspberry Pi is used 
to power the retro-tastic 
256-LED display 


The 1980s arcade 
machine was 
originally destined 
for the dump 


Several Gamescom 
attendees tried to 
buy the project on 
the spot 


Can't Drive This involves one 
player building a road, while 
the other drives it - fast! 


: ~~ % t. os Players receive 
wo: av a customised 
: , memento of 
them playing on 
the machine 


The company's 
first game was 
puzzle-shooter 
ChromaGun 


The team’s next 
project sees 
them play around 
with time 
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WATER 
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A Getting to the heart 
of the matter and 


SPEAKER SPEAKER 
replacing the original FRONT FRONT 
1980s kit with modern- LEFT RIGHT 
day processors and BUTTON PANEL 
Pi-powered additions 

> The schematic for the 
; 4D arcade machine, 
7 showing the importance 
f of the Raspberry Pi as 
a a controller 
ACTIVE 
BRITER: SUBWOOFER 
interactive elements such as motion cabinets). 


The fourth dimension in this case saw the 
inclusion of a water spray, fan, and console lights. 
For its Gamescom debut, Pixel Maniacs presented 
Can’t Drive This in a retro arcade cabinet, where 
hordes of gaming fans gathered round its four-way 
split screen to enjoy the action. 

Adding Raspberry Pi gaming to the mix was 
about aiding the game development process as 


much as anything. Andy Holtz, Pixel Maniacs’ Pixel Maniacs’ offices have several Raspberry Pi- 


software engineer, told The MagPi the team wanted controlled monitors and a soundboard, so the team 
an LED matrix with 256 RGB LEDs to render knew the Pi’s potential. 
Ssprite-sheet animations. 


“We knew we needed a 
powerful machine with 
enough RAM, anda huge 
community, to get the 
scripts running.” 


NOTEBOOK 


Co) 


The arcade version of the game runs off a 
gaming laptop cunningly hidden within the 
walls of the cabinet, while the Raspberry Pi 
delivers the game’s surprise elements such as 
an unexpected blast from a water spray. A fan 
can be triggered to simulate stormy weather, 
and lights start flashing crazily when the cars 
crash. Holtz explains that 
the laptop “constantly 
sends information about 
the game’s state to the 
Raspberry Pi, via a USB 
UART controller. The 
Pi reads these state 
i: © messages, converts it, 
. and sends according 
BAMES gamescom commands to the fans, 


water nozzle, camera, 


YOUR SCORE 
7824 


> Having played your : 
heart out, you get a 24.08.2018 16:58 
photo-booth-style 
shot of you in full-on 
gaming action 


Loot’Pickup al 6:30pm 
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Arcade gaming reimagined 


01 A Raspberry Pi 3B+ was used to trigger the 
water spray, lights, and fans, bringing an extra 


and the LED light matrix. So, when players drive 4 Pixel Maniacs 
; ; reprogrammed a element to the gameplay, as well as rendering the 

through water, the PC sends the info to the Pi, and hand-held games Be ee er ae eat 

[the latter] turns on the nozzle, spraying them.” console controller for aia 


. . . the arcade machine 
The arcade idea came about when Pixel Maniacs 


visited the offices of German gaming magazine 

M! Games and spied an abandoned, out-of-order 
1980s arcade machine lurking unloved in a corner. 
Pixel Maniacs set about rejuvenating it, Da Doo Ron 
Ron soundtrack and all. 


Sustained action 

Ideas are one thing; standing up to the rigours of 
a full weekend’s uninterrupted gameplay at the 
world’s biggest games meet is something else. 
Holtz tells us, “The Raspberry Pi performed like a 
beast throughout the entire time. Gamescom was 


The transformation from a decidedly unloved- 


M™ The Raspberry Pi delivers the game's 02) ie cactehiiesconsetsion metas 
; gaming machine owes a great deal to the team’s 
SU ae riIS@ eC | ements Su ch gS adn un eCXD ecte e imagination, as well as the additions the Raspberry Pi 


made possible. 


blast from a water spray @ 


open from 9am till 8pm, so it had to run for eleven 
hours straight, without overheating or crashing. 
Fortunately, it did. None of the peripherals 
connected to the Pi had any problems, and we did 
not have a single crash.” 

Fans were enthusiastic too, with uniformly 
positive feedback, and one Gamescom attendee 
attempting to buy the arcade version there and 
then. As Andy Holtz says, though, you don’t sell 


0 Can't Drive This is every bit as engaging and 


your baby. Instead, Pixel Maniacs is demoing it frustrating to play as other driving arcade games, 
at games conventions in Germany this autumn, but this one comes with the unexpected jeopardy of 
before launching Can’t Drive This across gaming getting blasted with water for your troubles. 


platforms at the end of the year. 
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The Knitting “y 


What can you do with a vintage 1980s knitting machine? You can 
turn it into a ‘Knitting Network Printer’, that's what! Nicola King : 
picks up her needles and probes a very crafty hack é t Tet Ait 


oo 


“= 
Cuen 


fare 


spanned the decades, but Sarah Spencer has tis ont . a Rae Se) nm 

arguably propelled that craft well and truly : ‘% 
into the 21st century, using her ingenuity, a slightly 
dated piece of knitting equipment, and a Raspberry 
Pi. Sarah has made a hobby of turning a dusty old 
domestic knitting machine from yester-year into 
something very special: a Knitting Network Printer 
that can produce some rather amazing FOs (that’s 
knitting terminology for ‘finished objects’ for the 
non-knitters among you. ) 2 cs ye ae an 


K nitting is an ever popular pastime that has 


“tene 


Sarah Spencer 


An Australian 
software engineer, 
Sarahisalsoa §  .»}»}»}»}©=©= 


ot Wn e* par eet eet pet eee” 


easeseoem™ 


keen maker and Knitting: 21st century style Agi 
ee Sarah’s interest in hacking domestic knitting HA 
her creations in an ; \ ienteseri a 
Etsy shop. machines began several years ago. As a software 
magpi.cc/fvCnbX engineer, she was keen to investigate the possibilities | | 
of marrying current technology with old, and OctoPrint for 3D printers, another popular 
her 1980s Brother KM950i knitting machine (no application for Raspberry Pi.” 
longer in production) has undergone something Taking several years to perfect, Sarah has made 
of a transformation over the past few years. The various modifications to her machine over that 


time, and explains, “With 
the addition of a motor arm 


M When | first picked up a Raspberry Pi, sae aneutadisee coisa: 
bie Nin | never imagined in my wildest dreams ee eee 


is getting very close to 
knitting machine 5 g y 


: . ! ' 1 ' : _ ” 
ee etd what I'd end up doing with it @ ie enue ios 
and sends them to it 
via the floppy drive become much larger since 

original machine came with an on-board scanner she began tinkering, as Sarah adds that she has 

to scan knitting patterns, and a floppy drive to back “specialised in knitting multicolour work using a 
them up. Sarah explains, “By using a floppy drive double-layered technique called double jacquard 
emulator written in Python and a web interface, which requires two beds of needles.” 

I can send an image to the Raspberry Pi over the Sarah’s approach is nothing less than practical: 
network, preview it in a knitting grid, and tell it to “T made a thing that can make things, so I need to 
send the knitting pattern to the knitting machine via make something with it, righte” The items that she 
the floppy drive port [...]. I call this setup OctoKnit, has made are impressive, including laptop covers 
in honour of a more famous and widely used tool, and scarves that she sells via an Etsy store. 
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‘Stargazing’ was 
commissioned by 
the EMF festival 

Its planets are 
aligned for the EMF 
opening time 


gitirghne Sarah makes 
The wavy line through the Caen vote personalised knits 
centre is the Earth's equator 


— to order via Etsy 
projected out into space FAANGULUN 
\ AUSTRALE in 
oe s REUe Shee 


- meer” 
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wet geneee™ 
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Pesveseeorneranees Heater Featuring 88 constellations, 
Sarah's stellar map is 4.6m 
wide and weighs 15kg 


acs * 


CAMELOPARDUS 


Her piéce de résistance, however, is 
extraordinary and ona very different scale... 
Stargazing: a knitted tapestry (magpi.cc/ZsvAjA). 


tte ewe 


Out of this world a ft 4 a2 aw \ . ‘a 66S ieee 
A huge undertaking that is 15ft (4.6m) in width, | y | rancaun aK Ly ae 
this celestial map of the night sky features all 88 eae | 


| meee | ie fo “eg 
constellations across both northern and southern ARIE : : 


A , : " . 1 a. w ‘a 3 
hemispheres. Sarah explains that this heavenly }- SI - (izes ie oc LPN 
MOON = gy 


piece of work was “knitted in seven panels x >. hh aPtE Ae, 
- zs a re t... i Q: “ iit a f “ wt ' x. ria Es 1 
stitched together by hand. The pattern on the ys is . ee te i ‘eouutedy x ee. 


® 


Raspberry Pi is 21 times bigger than the memory 4 hao, 5 a a> | | Chay ys 
available on the vintage knitting machine, so it’s BOM he pee , een € me usnus +e 


* ‘ 
; . . a) " 
knitted in 21 separate but seamless file transfers. iat 


It took over 100 hours of work, and weighs 15 kg.” in perf oe ‘ + “*CAPRICORNUS 

“When I first picked up a Raspberry Pi,” says v : 
Sarah, “I never imagined in my wildest dreams et | | ~ ae 1 
what I’d end up doing with it.” Well, she’s done a Bp ay MARS en _ 
something pretty amazing with it, and whether thin Nie G34. °SCOP uM a ae , f 
you’re a knitter, hacker, or simply an admirer of Sarah showed off her stellar AAAS J ‘a | SAGITTaAMUS 


mon work at an REA Group : “eRe aie Feo : : ae st 
cleverness, knitting never looked so good. hackathon in Australia : the ‘il %  S60R 
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GREATEST 
RASPBERRY PI 
PROJECTS 


We celebrate 75 issues of The MagPi with 
75 amazing projects from around the community! 


couple of years ago The MagPi builds - more than enough to showcase 
A hit 50 issues, so we thought 75 more amazing projects! 

we'd celebrate by putting As we’re the community magazine, 
together a list of the best 50 projects we wanted the community to have a say 
ever made. In the short amount of time in this list, so the top 50 projects on this 
between then and now, the Raspberry list were voted for by you, the readers. 
Pi community has gone above and Read on to find out what you folks think 
beyond and created some incredible is the best project of the last two years... 
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Amazing AI 


Projects 


Eben Upton 


CEO, Raspberry Pi 
(Trading) Ltd 


Eben Upton picks his five 
favourite Al projects 


e’ve seen an explosion of 
projects that make use 
of AI in the Raspberry Pi 
community over the last year or 

so, and while we like to think we 
helped to kick-start this with the 
AIY Projects issue of The MagPi, 

the community has run far beyond 
that initial kit. Eben tells us his 


favourite AI projects that he’s seen. 


‘really completes 
this daft yet 


IQ p ject 


There's Waldo 


Find the elusive Wally 


> Matt Reed 
> magpi.cc/LaGzbn 


I’ve never been a big fan 

of Where’s Waldo/Wally/ 
whoever, so using machine 
learning to automate the 
process of completing (and 
discarding) each book is very 
appealing to me. 
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Real-time engine 
management 


Adam Vaughan 
magpi.cc/ZqPXhU 


As Liam Fraser will attest, I'm 

a closet petrolhead, so seeing 
people do engine control of any 
sort with a Raspberry PI is always 
a pleasure. Add in the machine 
learning angle and this is a really 
sweet demo of what you can 

do with Raspberry Pi in a deep- 
embedded environment. 


Solar Pilot Guard 
Making flying safer 


> Foale Aerospace, Inc 
> magpi.cc/fHoUra 


Like a lot of people at Pi 
Towers, I’m a massive space 
cadet, so learning that 
Michael Foale has been using 


Zoe and Hermione 


Autonomous drones 


> Andy Baker 
> pidrone.io 


I was there for Andy’s 
flammable drone demo at 
the Birthday Party, so it was 
great to see it rising like an 
Al-powered phoenix from 
the ashes. 


Automating 
vegetable grading 


Makoto Koike 
magpi.cc/fDeLLK 


My all-time favourite. This 

is a lovely example of an 
individual engineer solving a 
very specific personal problem, 
using Raspberry Pi as a bridge 
between imaging, I/O, and 
(local) machine learning. 


our product (and Wolfram 
Mathematica) is very exciting. 

I loved the idea of him repeatedly 
flying his aeroplane unsafely 

in order to gather enough 
training data for the machine 
learning algorithm. 


Stunning Art 


Projects 


Liz Upton shows us 
five projects using PI 
to make art 

up with accessible 


A computing technology, 


we’ve seen many more art 
projects incorporate computers 
and technology in some way. Liz 
tells us some of her favourite 
examples of these arty projects 
in the intersection of STEAM. 


S more people grow 


Amazon rainforest 
simulator 


Poopi & Piter 
magpi.cc/ZhEiVV 


| wrestled a bit here. Does this 
fall under creative projects 

or conservation? | reckon It 
ticks both boxes; it’s a simply 
beautiful object | could stare at 
for hours, as well as a working 
Amazonian Wildlife habitat. 


Sound Fighter 


Hadoukens in D minor 


> Foobarflies 
> magpi.cc/fZxPGD 


Not just one of my favourite 
creative projects for the Pi, 
but probably my favourite 
project of all time. Two 
pianists play music, which 
also controls the angry people 
in Street Fighter. 


Joytone 


Anew instrument 


> David Sharples 
> magpi.cc/XxbZSE 


A completely new musical 
instrument, built around a 
hexagonally isomorphic layout 
which ensures that musical 
structures will have the same 
shape in whatever key they’re 
played. Revolutionary, clever, 
and really satisfying. 
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You must defeat 
my arpeggio to 
stand a chance 


Bigejen= 
Automated water 
droplet photography 


> David Hunt 
> magpi.cc/fvNmeA 


An oldie but a goodie: less than 
a year after the first Raspberry 
Pi was released, we started 

to see it being used as a piece 
of inexpensive photographic 
hardware. Dave Hunt’s gorgeous 
water droplet photography uses 
the Pi to coordinate a solenoid 
valve and camera shutter to 
stunning effect. 


Night in the museum 


The Workers 
afterdark.io 


uleyig aye] ‘UIAYSOW Aaxaly :1pas5 


What's creepier than a locked 
museum after dark? A locked 


museum after dark full of robots, Liz Upton 

that's what. This project allowed 

people to look through the eyes Director of 

of wandering robots in Tate eT USES NATE] 
oe 2 ae Raspberry Pi 

Britain after the witching hour. Foundation 
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CoderDojos 
Coolest Projects <° 


Young makers at CoderDojos make amazing things too 


e’re taking a break from showing you just 
W amazing projects to also highlight some of the 

coolest creations from the CoderDojo’s Coolest 
Projects events! These events feature amazing projects 
created by young makers from CoderDojos around the 


globe. Here are five incredible ones, but there are many 
more you can find at coolestprojects.org. 


Supporting refugee communities 
Jeroen magpi.cc/GhdBjg 


In the winter of 2016, many refugees were making their 
way to Europe. To try to help them adjust to their new 
homes, the then 15-year-old Jeroen decided to make an 
app for them. 

‘| had the opportunity to talk to refugee assistance 
organisations in Belgium and France,” says Jeroen, “They 
were enthusiastic to help me and they also gave me 
inspiration on the content and the conversations in the app.’ 

Jeroen’'s story found its way to local and international 
news, and he won the Future Makers category at Coolest 
Projects 2017. 
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Light up my helmet 
Enlightened bike safety 


> Kobe 
> magpi.cc/vcipGF 


Kobe is an avid cyclist, and because it is much safer in case 
he cycles to school every you would fall or crash.” 
day. This means that fora As well as the helmet being 


good portion of the year, he’s decked out ina load of LEDs, 
cycling in the dark. “Making and a battery to power it, Kobe 


M™ Making something that makes 
you more visible in traffic would 
be g good improvement @ 


something that makes you has installed a wireless remote 
more visible in traffic would control on the handlebars so 
be a good improvement,” he he can activate indicator lights, 


says. “I always wearahelmet, much like you see ona car. 


Amy's Buzzy Hive 


Save the bees 


> Amy 
> magpi.cc/RaUYPd 


“Malvina, one of our mentors, 

said ‘Wouldn’t it be great 

to do something to help the 

environment?:’” recalls Amy. 

“Another mentor keeps 

bees and said that the bee 

population is in danger (and 

that means no honey!), sol 

decided to do a project ona 

way to maybe find out why.” 
Amy’s project uses 

several sensors hooked up 

to a Raspberry Pi inside a 

beehive, which tracks bees’ 

numbers in an attempt 

to identify the cause of 

dwindling populations. 


| MagPi 


Donate Hair for Cancer Wigs 
Helping sick kids 


> Andrea’ > magpi.cc/WZLCPC 


Andrea's project takes the form of a short story that the 
seven-year-old created in Scratch. Andrea wanted to share 
the message about how donating hair can help out young 
patients who have cancer. 

“Coolest Projects 2017 was the perfect place with so 
many kids attending from all around the world,” says Andrea. 
‘| was hoping that they can see my project and to accept 
this cool idea for supporting kids with cancer.’ 


The Lost World 


A post-apocalyptic game 


> Matei > magpi.cc/kXcAdm 


Ten-year-old Matei loves science fiction, 
and came up with the idea for his game after 
reading some books set in a post-apocalyptic 
world. Instead of the usual gloomy setting, 
Matei’s game has a more hopeful outlook for 
humanity’s future. 

To create the game, Matei taught himself how 
to use the Unreal Engine, with some help from 


mentors at his local CoderDojo. An amazing 
achievement at age ten, which earned him the 
prize for the best Games Under 12 award. 


Raspberry Pi Foundation 
CEO Philip Colligan gota 
chance to see the project 


im 
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OO) MaigPi | Hee rue 


Projects ~ 
for Good 


Philip Colligan reveals his top-Tive 
world-changing Pi projects 


s well being an amazing computer for learning, 

the Raspberry Pi is a powerful force for good. From 
environmental protection to healthcare and citizen 
science, folks around the world are doing remarkable 
things with our favourite single-board computer. CEO of 
The Raspberry Pi Foundation, Philip Colligan shares his 
favourite projects with us. 


A 


Telemonitoring and drying of diabetic foot ulcers 


Ernesto Holguin otenmedical.com 
We met Ernesto Holguin 
from El Paso in Texas at the 
Houston Maker Faire, showing 
off his fantastic Diabetic Foot 
Health machine. It utilises the 
Raspberry Pi 3 to inspect feet, 
dry them, take images, and 
communicate other vital sign 
information with clinicians and 
family members. One in five 


diabetic patients visit a clinic 
about ulcerative wounds, and 
this machine improves the 
frequency of skin monitoring. 


CEO, The Raspberry 
Pi Foundation 
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ZS, 


youyUNs1E44 31IPa1D 


Do-it-yourself 
wireless networks 


™. 6 
Say 
i, 


Mazi 
mazizone.eu 


Arribada 


Harnessing green sea 
turtles for conservation 


Mazi uses Raspberry Pi to 
create hyperlocal wireless 
networks that are being used 
by communities from Athens to 
Zurich to fuel social innovation 
projects. Mazi was just one of 
the Pi projects that | saw on 

a recent visit to the amazing 
Knowledge Media Institute at 
the Open University. 


> Alasdair Davies 
> blog.arribada.org 


Arribada is the latest initiative 
from the amazing Alasdair 
Davies, a technologist, 

Pi enthusiast, and 
conservationist who is ona 
mission to make low-cost 
conservation technologies. 
Alasdair has created a turtle 
tag using Raspberry Pi Zero W 
and Camera Module that 
literally allows us to travel 
with the turtles. Amazing. 


Fesentience 


Tackling neonatal 
abstinence syndrome 


Project Rover 


Semi-autonomous 
bomb disposal 


> Engineering and Science 
University Magnet school 
(ESUMS) 

> magpi.cc/BikRuh 


> Staff Sergeant Jolley, 


Sergeant Rana, & 
The team at Fesentience Sergeant Paddon 
is using the Raspberry Pi > magpi.cc/cbRVjY 


to create a product that 

can mimic the maternal 
womb to help babies born 
with neonatal abstinence 
syndrome. A great example 
of Pi powering innovations 
in healthcare, which I predict 
will be one of the most 
exciting fields for applications 
of the low-cost computer in 
the next few years. 


This brilliant use of a Pi came 
out of a British Army Foreman 
of Signals training programme. 
What I love about it is that 

the three soldiers behind 

the invention had limited 
programming experience, but 
were able to quickly develop 

a robot that could sense and 
avoid obstacles. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS Tel: +47 990 80 900 
Nedre Strandgate 29 info@cdptech.com 
P.O. Box 144 www.cdpstudio.com 


NO-6001 Alesund, Norway CDPStudio 
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Agrihack 
Solving farming problems 
with a Raspberry Pi 


Projects 


Carrie Anne Philbin with five 
gmazing uses of Pi for learning 


MOONHACK 


> Agrihack 
> magpi.cc/BSrjpg 


Moonhack 


Breaking the code 
world record 


Agrihack brings together 
Australian children, coders, and 


earning is right at the heart of the Raspberry Pi farmers to solve problems with 


Raspberry Pi Foundation’s Carrie Anne Philbin selects her 
favourite educational projects. 


Ze 


experience, and an uptake in education was the driving 


force behind the board’s original development. The > Code Club 


> moonhack.com 


_——_ 


oS 


Moonhack is Code Club’s free 
| world-record-setting event 
"AK. ~ for kids aged 8-18 around the 

Crumble bot Te 4 = world. Held on 20 July (the 
; My anniversary of the Apollo 11 

‘ Moon landing), it entails kids 
all over the globe getting 
involved with coding projects. 
Every year it gets bigger, and 
Moonhack 2018 saw 35 865 kids 
from 58 different countries 
taking part. 


An inexpensive and \Z 
easy-to-control robot | 


> Crumble > magpi.cc/GxBVTM 


Raspberry Pi Certified Educator Nic Hughes 

introduced me to Crumble bots at a conference. 

Redfern'’s Crumble board Is inexpensive and easily 
programmed using a block-based interface. It has been 
designed with young children in mind, connecting easily to 
motors using crocodile clip cables. Students typically start 
with simple forwards and backwards motion, before facing 
the challenge of figuring out how to make their robots turn 
left or right. Design skills are used to build a stable and useful 


Digital Maker 
Staged Activity 
Badge 


technology. The Hackathon 
challenges are: reducing 
stored grain spoilage from 
high moisture, measuring the 
live weight of meat chickens 
to prevent overfeeding, and 
assisting the handover of farms 
and fisheries from the older to 
the younger generation. 


BBC Computer 
Literacy Archive 


A golden era of computer 
education projects 


chassis. Of course, anything can be a chassis: my Pringles Making with the Scouts > BBC 
tube Crumble bot is just one example. > magpi.cc/nqHDem 
> Scouts 
> magpi.cc/VgdkKij If you've ever wanted to know 


Getting digital making into kids 
hands is what the Raspberry 

Pi Foundation is all about, and 
the new badge activities we 
developed with the Scouts are 

a fantastic way to reach out 

to more children who may be 


more about the history of British 
home computing, a whole 
treasure-trove of interviews, TV 
shows, programming code, and 
photos has been assembled for 
your delectation and inspiration. 
The BBC's archive of its 
Computer Literacy Project (CLP) 


Carrie Anne is packed with professional 
Philbin , educational resources from a 

: ih a ten-year endeavour to teach 
Director of i a. 


Pi Axh 1 
Pes: , 
ay US ie ay eS 
“AGE es 
~~ 4 


Informal Learning 
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the nation computer skills. 


DINrPlate’ 


The simple way to. mount your Pi! 


A i ii 


e Industrial DIN rail mount 
¢ Open frame for better airflow 
¢ Integrated USB strain relief 


Pi Zero. version 


www.DINrPlate.com 


READER VOTED 
PROJECTS 


A voted for by you, the readers, 
here are 50 Raspberry PI projects 


Hoverbot 


A robot made from a hoverboard 
and an old table 


> Isabelle Simova 
> magpi.cc/CDEbOq 


While countless Raspberry Pi robots 
have been created, most of them 
are on the small side. Hoverbot, 
however, bucks this trend and 
comprises upcycled parts including 
a hoverboard and an IKEA table. 
Hoverbot is a large robot that is 
equipped with sonar sensors for 
obstacle detection and is powerful 
and sturdy enough to transport 
heavy items and even people. 
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bee 


The dress that awards 
points for social interaction 


> Clodagh O'Mahony 
> magpi.cc/xUoouA 


For her thesis project, Clodagh 
created a dress and an 
accompanying website to 
comment on the progression 
of social media interaction. 
Clodagh created a corporation 
named ‘QBee’, an abbreviation 
of Queen Bee, with the 
associated honeycomb theme 
playing a significant part in 

the look of both the dress and 
website. This corporation, if 
given true life, would provide 
a range of wearable tech 

— Similar to her dress - that 
would allow for the recording 


Museum in a Box 
Experience artefacts 
from afar 


> Museum in a Box 
> museuminabox.org 


Pop a museum object on 

top of the box and it will 
start telling you about itself. 
Through 3D-printed models 
and wooden sculptures, 2D 
images such as postcards 
and photography, and ‘do 

it yourself’ feedback cards, 
the team aim to break the 
disappointing, yet often 
necessary, Do Not Touch 
stigma of museums, allowing 
everyone the chance to get to 
erips with a history they may 
otherwise miss out on. 


of social interaction data, 
updating it to the wearer's 
online QBee account. 


Dog Treat Machine 
With motion detection 
and video capture 


> Eric Page 
> magpi.cc/2sTf5qU 


While pondering what to get Shirin, his fiancée, for her birthday, 
Eric Page realised how much she misses her dog Pickles while 
she’s at work. He decided to build a Dog Treat Machine to allow her 
to serve treats to Pickles remotely. There are four ways to trigger 
the Pi- powered device: email, MQTT, IFTTT, or Alexa. It then plays 
a sample of Shirin’s voice, dispenses some dog treats, and checks 
for motion using OpenCV analysis. 


FEATURE | MdfPi 


Tomy Turnin' Turbo 
Dashboard Out Run 


Classic video game in a toy 


> Matt Brailsford 
> circuitbeard.co.uk 


An underwater 
weather station 


Diemo Niemann 
save-nemo.org 


Matt Brailsford, picked up a Tomy 
Turnin’ Turbo Dashboard on eBay 
and had a spark of genius: why not 
turn it into a fully working Out Run arcade machine? Matt 
tells us it’s fun to play. “It was a little squeaky to start with, but I 
had just tightened everything up a little too much. It runs nicely and 
brings back those memories as a kid. It’s how I thought it felt to play 
with back then.” 


For the past two years, the Save 
Nemo Foundation has worked 
hard to protect coral reefs off the 
coast of Thailand and Indonesia. 
Its members have been sinking 
concrete blocks next to the 
reefs, allowing diving and 
snorkelling boats to safely moor 
by using them as anchor points. 
Nemo Pi is a smart buoy able to 
measure temperature, visibility, 
OH levels, and the concentration 
of CO, and nitrogen oxide at 
each anchor point. 


This robotic fish swims 
with real ones 


Robert Katzschmann 
magpi.cc/kjsBkZ 


In the depths of the South 
Pacific, a strange new fish is 
exploring the Rainbow Reef. 
Flexing its tail from side to side 
to propel itself serenely along, it 
captures the underwater scene 


using a camera - with a fish-eye 

, lens! — mounted in its head, Trading card Scanner/organiser 
Monomep| which also contains a Raspberry Using Lego to scan card collections 

A music box featuring old Pi 2, among other electronics. 
and new technology 


> Michael Portera > magpi.cc/YyscOC 


> Joon Guillen 
> magpi.cc/uDPImr 


Michael envisaged a simple system that would spin and 
push preloaded cartds forward to be photographed and 
uploaded for digital storage and processing. The idea was 
to make light work of organising and valuing even the 
largest of collections. 


With hammers hitting the bars 
of a toy glockenspiel to play a 
tune, the Monomepi sounds 
just like an old-fashioned 
music box, but this Pi- powered 
contraption is based on new 
technology... and quite a 

lot of Lego. The Monome is 
connected to a Raspberry Pi 3 
running a step sequencer 
program, which registers the 
user’s button presses on the 
Monome and lights them 

up accordingly. 


C-Turtle 


This mine detector could save lives 


> KevinS Luck’ > magpi.cc/2yzh4pu : Ge re s 
ce \t =, eas 


It’s a sad truth, but right now the world is littered 
with an estimated 110 million land-mines. C-Turtle 
uses machine learning to figure out how to walk 
across the most unusual and hazardous of terrain, 
constantly adapting to its surroundings. 


a“ 
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MagPi 


A better baby monitor 


Dmitry lvanov 
magpi.cc/2jy01v0 


This advanced baby monitor 
was created due to frustration 
with the limitations of 
commercial baby monitors. 
Dmitry originally put all the 
pieces in a lunchbox before 
upgrading to a custom case 

— it includes a microphone, 
an IR camera, and can be 
accessed via a web browser. 


Pi-powered takeaway 


> Ehsan Rahman 
> magpi.cc/2mFCdZB 


Automation is easy with a 
Raspberry Pi, and Ehsan 
decided to use it to create an 
order system at his father's 
restaurant. It connects to 
some tablets which waiters 
use to take orders, and they're 
then printed out via the 
Raspberry PI. 


3D Pac Robot Man 


A real-life classic 
> Emanuele Coletta > magpi.cc/FFVwSt 


Pac-Man Is a timeless classic that has been remixed and 

remade in many ways, Including cult-classic Pac-Man Vs. In 

this edition of the game, one person controls Pac-Man in the 

maze, while friends control the ghosts and try to stop them. Who you gonna call? 
Emanuele's version takes the concept one step further by 

creating the maze and characters in real life using robots. Anthony Dipilato 
magpi.cc/bLPSrp 


——<——5 ee Anthony’s Ghost Detector 
is actually a present for his 
father, an avid watcher of 
paranormal investigation 
shows. It started off as an 
electromagnetic field meter, 
but an IR camera was added 
to the build. While the case 
resembles wood, it’s actually 


3D- printed. 


Recreates the joy of using a Polaroid Wh qt starte q out 
Toby Hendricks magpi.cc/tcGRGh qs an experi ment 

Toby, aka musician Otem Rellik, was frustrated with turne q | aene 

iPad music apps. So he decided to make his own 

using a Pi Zero and the Pure Data programming wondertul-lookin G, 

language. What started out as an experiment turned , 

into a wonderful-looking, multifunctional synth. Mu tif nctiona | synth 
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Instagif NextStep 
The printable GIF 


> Abhishek Singh 
> magpi.cc/2yKkc1T 


This fun project obviously 
doesn't print a moving image 

— instead, Abhishek has made 
it so that a very short video Is 
Uploaded to a cartridge which 
looks like a Polaroid picture 
and houses a small screen. 
You insert the cartridge into the 
front of the camera and It spits 
it out once it’s ready. 


Hi ty! 


bed a 


Automated libations 


Stefan Hoving 
magpi.cc/uiTVEP 


While making a cocktail by 
hand can be fun (especially 
when you fudge the 
measurements), it’s also 

very cool to be able to have a 
cocktail dispensed straight 
into a glass. It’s all a bit Star 
Trek. We especially like the 
classy presentation of this Pi- 
powered booze maker. 


Play chess against a robot 


Joey Meyer 
raspberryturk.com 


The Mechanical Turk was 

an old parlour trick where a 
chess master would sit ina 
box and control a dummy so 
it looked like it could play 
chess automatically. The 
Raspberry Turk is not a trick: 
it’s an actual robot you can 
play chess against. And that’s 
pretty cool. 


What can't this robot do? 


Ahmed Al-Faris 
magpi.cc/PKaxfz 


Raspberry Pi robots can be 
expanded and built upon quite 
a lot, but we’ve never seen a 


robot with this many functions. 


It has a manipulator arm, five 
control methods (including 
autonomous), video streaming, 
Alexa voice interaction, 
obstacle avoidance, and can 
even do order picking. A true 
renaissance-bot. 


MagPi 


Aphex Twin 
Midimutant 


An evolving synthesiser 


> Dave Griffiths & Richard James 
> magpi.cc/hptLSQ 


Instead of manually programming 
a synth yourself, the Midimutant 
runs through endless combinations 
to create a new series of synth 
sounds through code mutations 
and mixing. After a couple of hours, 
it usually produces something that 
sounds good. 
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Seeing Wand 


It speaks an item's name 


> Robert Zakon 
> magpi.cc/kKzCmJ 


Robert Zakon has built a Seeing 
Wand that can speak the name 
of whatever it's pointed at. 
Housed in a makeshift PVC 
tube, a Pi Zero is connected 

to a Camera Module that 

takes a photo when a push- 
button is pressed. The image 

is sent to Microsoft's Cognitive 
Services Computer Vision API 
to get a description, which Is 
then spoken. 


Recreates the joy of using a Polaroid 


Pierre Muth magpi.cc/beJzih 

We’ve seen many digital camera builds using the Raspberry 
Pi and Pi camera. From 3D-printed cases to retrofit vintage 
classics, the majority act as simple point-and-shoot 
camera. The PolaPi-Zero, however, takes its lead from the 
iconic Polaroid, utilising a thermal printer within its body 
to deliver instant prints of your subject matter. 


P| Film Capture 
Converting old film 
reels to digital video 


> Joe Herman 
> magpi.cc/AfykKA 


Restoring home movies 
captured on film can 

be a real challenge. 

Film conversion |s a time- 
consuming and often 
expensive task. One maker, 
Joe Herman, took matters 
into his own hands by 
hooking up a Raspberry 
Pi Camera Module to 

an old projector. 


Teletext makes a comeback 


0 EFF 


Peter Kwan magpi.cc/qGYOkS 


7778501 STROUD BAMBOO: 
503 TESTCAROS Enpexe 8 
S02 UKEFAK 

540 Ccye 


We’re delighted that teletext has been revived by the 
Teefax project. Users can install the free software 
(magpi.cc/2dssVeo) on a Raspberry Pi, connect its 3.5mm 
video output to a TV (via the SCART socket), then hit the 
teletext button on the remote control. 
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Scientific study aid 


Giorgo Gilestro 
magpi.cc/2i3vTHt 


When a group of researchers 
looked for a low-cost way 

of conducting studies in 
neuroscience, they turned to 
our favourite computer. The 
result is a machine with the 
potential to make ground- 
breaking discoveries about 
common human behaviour. 
And its secret ingredient? 

A load of flies! 


Security Robot 
This robot security guard 
is an arresting sight 


> Josh Starnes 
> magpi.cc/2DNur9h 


Inspired by sci-fi movies such 
as Short Circuit, Evolver, and 
Star Wars, Josh got to work 
on an affordable DIY robot 
that can trundle around the 
streets, operate in cold and 
wet weather, work well in low 
light, and communicate. 
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A weaving wonder 
controlled entirely 
by Raspberry Pi 


> Fred Hoefler 
> magpi.cc/eoZTUx 


When Fred Hoefler sent back a 
computer-controlled tabletop 
loom after it stopped working 
with his MacBook Pro, his wife 
Gina suggested that he should 
be able to build one with “one 
of those Raspberry Pi things 
of yours.” Fred recalls, “The 
most reasonable answer | 
could come up with was: ‘asa 
matter of fact, I think I can.’” 
A project was born. 


Little Green Tower 
An aeroponics tower that 
grows some tasty veg 


> Chris Johnson 
> magpi.cc/GDOZUk 


“For the last five years I 
have been designing and 
refining an aeroponics tower 
system that is particularly 
well-suited to growing leafy 
green vegetables,” Chris tells 
us. “The goal is to design 

a computer-controlled, 
modular, compact, and low- 
cost aeroponic system that is 
easy to replicate.” 


| MagPi 


P| Deck 


Digital music can't be scratched 
- or can it? 


> Daniel James 
> 64studio.com 


Daniel and his colleague Chris 

Obbard at 64 Studio put a Raspberry 
Pi 3 alongside a standard vinyl deck, 
eliminating the hassle and expense of 
hooking digital decks to a laptop. They 
figured that all you need is a USB stick 
packed with music files. “As long as 
there is low latency in both directions 
of travel, you can make effects such 
as rubbing the kick drum beats, 
scratching, and backspins sound, 

feel and look realistic,” Daniel says. 


Steampunk Pi Jukebox 


Retro-futuristic music-streaming device 


> Matt Van Gastel > magpi.cc/2CRrL6Z 

Matt has turned the main assembly of a 1930s Westinghouse 
radio receiver into a Pi-powered modern player. He began the 
project by tearing out the innards from the old tube amplifier. 
‘| had looked at making an actual tube amplifier, but the cost 
was too high for the quality,” Matt tells us. “But | found the 
JustBoom site and found this HAT fitted the bill” 
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Aquaponic Domestic Garden 


Veg and fish living in harmony 


> Diego Braga »>magpi.cc/FLTVFM 

Aquaponics Is a bit different from hydroponics — in this method, 
plants and fish co-exist and create their own ecosystem to 
feed each other. The fish fertilise the plants, and nutrients 
from the wet soil drop down into the tank below. 


Ghost in the pawn 


Tim Ness, Alex Angelov, 
& Alex Smith 
magpi.cc/LxbagV 


Chess software is readily 
available these days, so it was 
easy for Tim to get it running 
on a Pi. The real trick was 
inventing a system whereby 
a semi-hidden robotic arm 
moves chess pieces using 
electromagnets, all dictated 
by the chess software. 
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Half-Tesla, Half-Honda, all Pi 


Jim Belosic & Michael Mathews 


magpi.cc/NiQMmj 


This amazing hybrid uses a Raspberry Pi as an on-board computer 
which monitors the motor and allows you to configure it. It 
features a retro, eighties-style display and uses toggle switches to 
complete the old-school aesthetic. Jim uses it for drag racing and 


it’s extremely fast. 


Tetris under coffee 


Andreas Rottach 
magpi.cc/EWRCvg 


We’ve seen a few tables that 
have displays in them, but 
none that looks like this table 
made by Andreas. You can 
play several games on it, but 
honestly the gaming aspect 
isn’t the most interesting - 
it’s the custom, giant pixels 


that provide amazing imagery. 


Ms 2 


Photo Booth 
DIY wedding photography 


> Jack Barker 
> magpi.cc/2sNsRic 


Photo booths at wedding 
receptions are all the rage at 
the moment. Jack realised he 
could make something better 
with a Raspberry Pi though, 
and created a Pi-powered 
photo booth for his own 
wedding. It even gives you 
posing advice! 


Lunchbox Arcade 


Burger time or 
BurgerTime? 


> Daniel Davis 
> magpi.cc/Aivheb 


When you've already built 

a full-size arcade cabinet, 

the only way to go Is smaller. 
Daniel wanted to make a more 
portable arcade device, and 
after purchasing an old metal 
lunchbox, that's exactly what 
he did. 


Extraterrestrial forecasting 


Alex Schwarz 
magpi.cc/gpwrsv 


Is there weather in space? 
The short answer is yes, and 
Alex’s weather station makes 
use of radio waves to keep an 
eye on it. It ‘listens’ for solar 
wind and any changes in the 
Earth’s magnetic field, which 
is then tracked by graphs. 


Automated star following 


Mike Hamende 
magpi.cc/MLwYio 


Automatic tracking is 
something a lot of higher-end 
telescopes do, but with a bit of 
know-how and a custom-built 
mount, Mike was able to get 

a Raspberry Pi to control his 
telescope. It makes it easier 

to find and then keep specific 
celestial bodies in sight. 


Beneath the sand surface 
is a robot called Sisbot. 
This moves the ball using 
a powerful magnet 


Magi 


i. 


Pi-powered embroidery 


Alessandro Benanti magpi.cc/LpAyYu 428 
Automated embroidery machines that use a computer 

can cost a lot of money, so it’s amazing that Alessandro 
managed to upcycle an old sewing machine to do the same 
job for less than £200. It’s all automated and uses a Pi to 
control it all. 


Sisyphus Table 


Beautiful robotic sand art 


> Bruce Shapiro 
> magpi.cc/2fUUaRN 


We love seeing amazing art projects 
that use the Raspberry Pi - this one is a 
beautiful coffee table that uses a robot 
to create Spirograph-esque patterns 
under the glass. You can even buy one 
yourself, if you have a few grand spare. 
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MagPi 


_ FM 3-Channel 3-Station 


WIRELESS 
INTERCOM § 


Google AIY kit inside an old FM wireless intercom 


Martin Mander magpi.cc/2vPQK6E 


When Martin Mander saw The MagPi was giving away a 
free hardware voice kit from Google in issue 57, he did the 
sensible thing and rushed off to buy a copy. But after he 
assembled the components, placed them in the cardboard 
housing, and pressed the button to activate the Google 
Assistant to ask a question, he started to think about the 
future possibilities. 

“The family and I enjoy the local car-boot sales and 
I’m always looking for old, obsolete, or broken technology 
that I can use in projects,” he says, relishing the chance of 
picking up something from the 1970s and 1980s. 
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Wizard Chess. 


A fully working Harry Potter Wizard's Chess set 
> Bethanie Fentiman > magpi.cc/dPjCUk 


Bethanie Fentiman can't play For her A-level computing 
chess, but when her imagination coursework, Bethanie took an idea 
sparked and the opportunity that had been nestling in the back 
presented Itself, she brought of her mind, and turned it into a 
the iconic game of Wizard's reality. Well. as much of a reality 
Chess from Harry Potter to one can create when the literary 
life using a Raspberry Pi. version includes battling chess 
stepper motors, and possibly a pieces that leave their opponents 
little magic. crushed to rubble on the board. 


Fresh light on the idea of a motion-sensing illuminated mirror 


Roberto Tyley magpi.cc/2WVeHNE 


On reflection he could have that would shine brightly 
just bought a lamp, but after whenever anyone wandered 
Roberto Tyley stood on one by? One with individually 
too many of his children’s controllable LED lighting 
toys in the dark corners of that would directly respond 
his bedroom, he was hit by whenever someone posed 

a flash of inspiration. What in front of it, perhaps? As 
better way of illuminating light-bulb moments go, he 
the room, he mused, than a admits it was certainly high 
full-length portrait mirror on the wacky scale. 


Project MyHouse 


This smart doll’s house features 
gesture recognition 


> Maks Surguy & Yi Fan Yin 
> magpi.cc/sGPTSi 


Maks and Yi Fan conceived the idea of 
this interactive doll's house. Inside this 
cool crib, various features — including 
lighting and shutters - can all be turned on 
and off by the simple wave of a ‘wand (a 
PlayStation Move controller), with the helo 
of some clever coding and a Raspberry 

Pi 3. You can see a demonstration video 

at youtu.be/6EiITWZfPm3k. 

‘| thought a smart dolls house would 
be a great tool to demonstrate technical 
innovations to people in an approachable 
way, Says Maks, who worked with Y! 

Fan over a ten-week period, designing 
and constructing the clever little 
doll’s domicile. 


When someone stands 
inside the frame, Take 
Photo is pressed on 


the laptop software, - 
and the images are ~~ 


- captured and saved 


A relatively inexpensive 
full-body 3D scanner 


Poppy Mosbacher 
magpi.cc/2xRmUjR 


While learning to make her own clothes, 
Poppy Mosbacher bought 27 Pi Zero 
Ws and 27 Camera Modules, 27 Pi Zero 
camera cables, and 27 USB to micro USB 
cables, as well as an assortment of battery 
packs, power regulators, wire connectors, 
and other electrical items. Inspired by 
Richard Garsthagen (magpi.cc/2xVr3Vr), 
Poppy then looked at making the scanner 
affordable and portable. 

“Tt opens up new possibilities, such 
as of scans of children who won’t stay 
still long enough for the single camera 
method; building a personal database of 
scans taken at regular intervals to see the 
effects of aging; and making avatars for 
VR environments.” 
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gon tas 5 
Parts | es HAA aaa 
> 7-inch display se rar 
> Poster frame 3 zt 


> Theme park 
memories 


Daily Prophet UE 
Pi-powered magic newspaper a: 
a a 


Displaying holiday memories is something many of 
us think about. When Piet and Linda returned from 
the Wizarding World of Harry Potter, they had a lot of 
excellent video but nowhere to display it. Instead of 


getting one of those boring moving photo frames, Piet 
decided to take some inspiration from Harry Potter and 


M Instead of getting one of those 
boring moving photo frames, 
Piet decided to take some 
Inspiration from Harry Potter @ 


A It displays images 
and videos, much 
like its fictional 
counterpart 


<The electronics are 
sneakily hidden 
behind the frame 


create their own Daily Prophet in their living room, 
complete with video display for authenticity. 

“First, I designed the whole poster in Photoshop,” Piet 
tells us. “Within the design, I marked an area with the 
exact size of the Raspberry Pi screen. Next, I plotted the 
poster on normal paper at 100 percent, so the marked 
area still matched the Raspberry Pi screen.” 

Piet was able to mount the frame over a small 
cupboard, making hiding the electronics easier. The 
videos have a sepia filter on them to fit in with the 
newspaper aesthetic, and a motion sensor waits for 
someone to come close to it before playing any video. 

A nice power-saving technique. 


Want to learn about 
using omxplayer to 
play videos? 


Check out the documents 
on the GitHub: 
magpi.cc/ABdFRJ 
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PIOcket-Tiny Pi 


A tiny gaming Pi 


> Peter Barker >» magpi.cc/CDXVIT 


People love to make very small things with the Pi Zero, and 
Peter is no different. After getting all the parts to upgrade 
an old Game Boy into a retro gaming powerhouse, he 
couldn’t bring himself to take the working Game Boy apart 
and decided to make the smallest gaming Pi that he could. 
“Things progressed from there, really,” 
Peter explains. “I didn’t like how big the 
circuit board was for the screen, and 
realised that there weren’t all that many 
bits to it, so I started designing my own.” 
His resulting Game Boy Zero build led 
him to make an even smaller version: 
the Tiny Pi. It uses a1.44-inch screen, 
a five-way joystick, and has two 
push-buttons. You can build one 
yourself with his available a 
STL files, or using one of ¢ 
the kits he’s now selling 
(magpi.cc/byPfTG). 
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> Custom PCB 
> 1.44-inch display 
> Pi Zero 


A To get a true sense of 
its scale, here it is next 


Make your own hand-held to a classic Game Gear 
retro gaming device > Peter designed custom 
Using our guide in issue 55: PCBs for his project 


magpi.cc/55 
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Parts 


> Raspberry Pi A+ 

> Adafruit 2.4-inch TFT touchscreen 
> Adafruit Pi Protector case 

> 1000 mAh lithium polymer battery 


4 > Velcro wrist strap 


Windows 98 
Watcn 


Wind back the clock with this chunky wristwatch 


> Michael Darby >» magpi.cc/eYtwCn 


aa Many Yedrs lqter YOu lool back on it If Microsoft had designed a smartwatch back in the 


late nineties, it might have looked something like this! 
gnd want to relive it. | think time NGS | Michael Darby, aka 314reactor, has built a chunky, 


Pi- powered wristwatch running the Windows 98 


g funny way of keeping more of the | operating system. 
! While he admits the ancient OS used to drive him mad 
good than the bad within memory @ 


back in the day, he has an odd nostalgia for it. “Many 
years later you look back on it and want to relive it. I 

v Ara euler pease think time has a funny way of keeping more of the good 

buttons, is mounted on the Pi than the bad within memory.” 

Once he’d accrued the required components, including 
a Raspberry Pi Model A+, it only took a few hours to 
put together. He has since written a detailed build 
A tutorial (magpi.cc/yXfgmx). 
You can learn : The watch is powered by a slimline LiPo battery 

all about O | \ connected via a PowerBoost 500 with switch, while Velcro 
' feet secure the watch body to a wrist strap. 

Michael has received plenty of positive feedback for 
his Windows 98 Watch, which he wore to Raspberry Pi’s 
Fifth Birthday Bash. “The reaction has been crazy; I never 
expected it to take off like it did, but I’m very happy it did 
and it has inspired me to create more and work harder.” 


Windows 
10 1OT Core 
in issue 48: 


magpi.cc/48 
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Parts 


> Raspberry Pi Zero 

> ESP8266 

> Arduino 

> 128x64 1.3-inch OLED screen 
> RGB LED and vibromotor 


A Fancy assembling 
your own smartphone? 
You'll soon be able to 
buy a ZeroPhone kit 


| MagPi 


Zero Phone 


Turning a Pi Zero into a mobile phone 
> Arsenijs Picugins >» magpi.cc/XAMjks 


ZeroPhone is an open-source project to create a mobile 
phone kit for the Pi Zero. Owners of ZeroPhone will 

be able to make calls and send text messages. It will 
also have basic apps such as an alarm clock, calendar, 
calculator, web browser, and music player. 

Behind the project is Arsenijs Piugins, an 18-year-old 
student from Riga, Latvia. He now has a team of people 
helping him. 

The open-source software approach is “likely to be 
secure and not privacy-invading,” says Arsenijs. You can 
disable features you don’t like, and it doesn’t depend on 
any cloud services. You will be able to install firewall, I2P, 
and TOR nodes, as well as secure messenger Services. 

“It’s open-source, Linux- powered, and you can make 
one yourself for S50,” he says. Since the project first 
appeared in The MagPi, Arsenijs has taken the project to 
Crowd Supply for funding. 

“For me, this project is a huge undertaking that, if 
done right, will influence the way we perceive mobile 
phones,” remarks Arsenijs. He explains that it will help 
solve privacy and security concerns, as well as allow us to 
develop better open-source GSM technology. It will also 
help power mobile phone hacks. 

“Besides, this is an open-source Linux-powered phone 
you can independently assemble for less than $50,” 
observes Arsenijs. “That’s pretty cool.” 


<< ASIM800 GPS module 
and antenna are used 
to connect to the 
mobile phone network 


’ You can connect 
: —/ g Raspberry Pi to a 
>. 
mobile network with 
Holgram.io's Nova: 
magpi.cc/WXGKxH 
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The Joy-Cons are used to control the games. 


After much struggle, Christopher managed 
to get the analogue sticks working 


~ DISwiItc 


Retro gaming with a modern twist 
> Christopher Foote » magpi.cc/epZyLp 


hen the Nintendo Switch was first released, 
it seemed like it would be an inevitability 
for someone to replicate the form factor and 
controller functions to make a Pi- powered retro console. 
Within a few months, Christopher Foote had managed to 
do it. However, it wasn’t quite as easy as 3D-printing a 
few controller connectors. 

Surprisingly, the Linux Joystick Mapper worked with 
the Joy-Cons — the detachable controllers on each side 
of the Switch. However, there was one problem, as 


M1! can play one-player with 
both controllers to fully emulate 
gd Nintendo 64 or PlayStation & ey een OT ae 


> 7-inch touchscreen 
> A big battery 


Parts 


Christopher recalls: “It worked great apart from the 
analogue sticks, so I looked through the code for a few 
hours, figured how Linux Joystick Mapper worked, and 
reprogrammed it for Joy-Con compatibility.” 


Custom case 

That was the first step to getting the entire setup aie pe eee e Wiles 
working. Next was the case and assembling the hardware, messy 3D print, though 

using a 7-inch touchscreen display, an extended 
headphone jack, built-in speakers, and a custom 
3D-printed case. The real trick to the case is that the 
Joy-Cons can slot into it, much like the real thing. 

“T took my Switch and a pair of digital calipers and I 
measured the inserts for the controllers,” Christopher 
says. “I can play one-player with both controllers to 
fully emulate a Nintendo 64 or PlayStation controller... 
The Joy-Cons also load different controller maps.” 


More than games 
It’s an amazing feat, and it doesn’t just run RetroPie 
either: you can also watch stuff via Kodi, and Christopher 
is trying to figure out Steam streaming as well. 

We think it’s great, and apparently so did the folks 
in the community, as you have voted it to be the most 
amazing Raspberry Pi project of the last two-or-so years! 
We wonder what amazing projects we’ll see over the 
next two. Mf 
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The 3D-printed case holds the Pi 3 and other 
components and it includes the locking 
mechanism for the Joy-Con controllers 


The 7-inch Raspberry Pi Touch Display 
is at the heart of the project, which also 
makes use of RetroPie for emulation 


Using digital callipers, Christopher The touchscreen aspects 


was able to replicate the Switch's are also replicated from 
detachable controller function the Switch 
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SUBSCRIBE TODAY 
FROM ONLY £5 


UPTO SO /o 


MODMYPI VOUCHER 


» FREE Delivery 
Get it fast and for FREE 


Exclusive Offers 

Great gifts, offers, and discounts 
Great Savings 

Save up to 35% compared to stores 


Low Monthly Cost (from £5) 
» Cancel at any time 

» Free delivery to your door 
» Available worldwide 


£55(UK)  £90(USA) 
£80 (EU) £95 (Rest of World) 


Free Pi Zero W Kit with 12 Month upfront subscription 
only (no Pi Zero Kit with Rolling Monthly Subscription) 


© Subscribe online: magpl.cc/subscribe 
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JOIN FOR 12 MONTHS AND GETA 
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je) 
WITH YOUR SUBSCRIPTION 
Bg 
Pi Zero W 
' a cm 
Pi Zero W case a Beaee a: 
with three covers i OH) te gH 
USB and HDMI 
converter cables ad 


Camera Module 
connector 


Offer subject to change or 
withdrawal at any time 


SUBSCRIBE 
on app stores 


From =2.29 —. 


>» Google Play 


magpi.cc | 41 


MagPi 


Top Tip 


42 


Phil 
King 


When not subbing 
The MagPi and 
editing Raspberry 
Pi books, Phil 
enjoys watching a 
mixture of quality 
(Endeavour, The 
Crown) and other 
(old Dynasty re- 
runs) TV. 


You'll Need 


Raspberry Pi TV HAT 
Wireless network 


Computer 


Recording 


Add a hard drive 
or USB stick to 
your Pi to turn it 
into a capacious 
homemade PVR 
with LibreELEC. 


magpi.cc 


with the TV HAT 


Set up your new ddd-on to stream live TV from and to a Raspberry Pi 


he latest official Raspberry Pi add-on is 

a must for telly addicts. The Raspberry Pi 

TV HAT enables any Raspberry Pi (with 
40-pin GPIO) to decode live digital TV signals and 
stream them to remote devices — such as another 
Pi, computer, or even a smartphone. The HAT’s 
built-in Sony CXD2880 tuner supports DVB-T2 and 
DVB-T standards (Freeview in the UK), so you can 
watch all your favourite channels. Here we show 
you how to set it up, and even use it to turn a Pi 
into an all-in-one TV/PVR. 


Bh 
a 8 
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. 
Connect your TV aerial 


cable to the HAT via 
the supplied adapter 


Watch live TV from your Pi with the TV HAT 


Pere Peer eee rit 


Assemble and mount 

Insert the thin end of the supplied silver RF 
cable adapter into the gold connector on the side 
of the HAT. Take the supplied 40-pin header and 
insert its pins into the holes in the underside of the 
HAT — not into the black female header on the top! 
Mount the HAT on the Pi, with the RF adapter at 
the microSD card slot end. To make it secure, you 
can screw it in using the supplied stand-offs. 


With the supplied header 
inserted on its underside, 
the HAT is mounted on the Pi 


Install Tvheadend 

Connect a coaxial RF cable from a TV aerial 
socket to the RF adapter on the HAT. You’1l need 
decent digital terrestrial TV (Freeview in the UK) 
reception for the tuner to work. With Raspbian 
Stretch installed on its microSD card, turn on the 
Raspberry Pi — a green LED will light on the HAT. 

We need to install a back-end TV service to 

stream video: we’ll use Tvheadend. To install it, 
open a Terminal window and enter: 


sudo apt-get update 
sudo apt-get install tvheadend 


Configure Tvheadend 

It takes a few minutes for Tvheadend to 
install, so you may want to go and make a cup 
of tea. Once installed, a package configuration 
screen will appear and you’1l be prompted to 
enter a Tvheadend administrator user name. 
For simplicity’s sake, enter kodi for this, then 
also enter kodi for the password — you can always 
change it later if you prefer. You’re now ready 
to log in from another device. 


Log in remotely 

Now that Tvheadend is running, you can 
access it from another computer (possibly a second 
Raspberry Pi). In a web browser, enter this address: 
http://raspberrypi.local:9981/extjs.html. If that 
doesn’t resolve, use the Pi’s IP address instead, 
followed by :9981/extjs.html. Log in using kodi for 
both the user name and password. A configuration 
wizard will appear, enabling you to choose the TV 
network type and transmitter. 


Configure TV network 

In the configuration wizard’s ‘Network 
settings’, it should show “Tuner: Sony CDX2880 #0 
DVB-T #0’. For the Network Type, choose ‘DVB-T 
Network’. For predefined muxes, select your local 
transmitter: for example, ours was uk-Rowridge. 
Upon clicking Save & Next, it’1l start scanning for 
muxes and services (channels). After it reaches 
100%, tick all three boxes (Map all services, 
Create provider tags, Create network tags) and an 
electronic programme guide (EPG) will appear. 
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(Gi Electronic Program Guide | *) Digital Video Recorder | J” Configuration | # Status | @ About = No verified access (login) Storage space: 8GIB/0/14GiB 12:18:17 


All 
Details 
Pia | 
&o 
&O 
oO 
&O 
€o 


¥ | Search title Fulltext Filter channel v. ||| Filter tag ¥. Filter content type wallll F 
Progress Title Subtitle Episode Start Time Duration 
61% | "This Is BBC Four BEC Four is the BBC channel for people w... Wed, Oct 03,0... 13 hrs, 28 min 
29% | "Kpanded TV (2 Live TV Player 
| : horeeieetas =—_ BBC ONE South x!) © © © | BF Select stream profile vi ae 
bo | “sonn Suchet 
pate "Jim White 
ptr oe "Lauren Laverne 
TT" | | "Sasha Twining 
‘Adele Roberts 
/, _ “Mid-Morings with Nick Snaith 
4) Sasha Twining 
a: ae "Live Conservative Party Conference 
pom ee | "Asian Network's Big Debate 
ate | "Myleene Klass 
po a "Anna Foster 
ec | "A 
"Sarah Walker 
TT | "Mike Toolan 
ee | “dames O'Brien 
22% ~—| "Blazer back at 3am 
—s | "BBC Newsroom Live - Stay up to date on the day's top stories, wit... Wed, Oct 03,1... 2hrs 
45 | The Sound of Fury (1950) Film noir starring Frank Lovejoy and ... Wed, Oct 03,1... 1 hrs, 50 min 

A Youcan access 
the EPG and 
: watch live TVina 
Watching TV web browser ona 


. remote computer 
You can now watch live TV streamed from 


the TV HAT in your browser. In the EPG, click the 
TV icon to the left of any programme to show it in 
a window, which you can expand to full-screen. 
There are also options to schedule and record 


shows — use the Help option for more details. 


As well as using a web browser, you can view 


the TV stream from a variety of clients, including 
Kodi, omxplayer, VLC, and smartphone apps — 


see magpi.cc/ZpJtwd. {i 


Using LibreELEC 


The live TV stream from the TV HAT can be accessed 
in the Kodi media player, most easily by using 

the LibreELEC OS on a Raspberry Pi. Install the 
Tvheadend client by selecting Add-ons > Install from 
repository > PVR clients > Tvheadend HTSP Client. 

In addition, using LibreELEC, it’s possible to set up 
both the Tvheadend client and server on the same 
Raspberry Pi - a Pi 2, 3, or 3B+ is recommended - 
for an all-in-one TV/PVR device. To do so, select 
Add-ons > Install from repository > Services > 
Tvheadend Server 4.2, and install it. Access it from 
another computer using the IP address followed by ——— 
:9981 and set it up as in Step 5. You can then access 7 
it from within LibreELEC (with the Tvheadend client To p TI p e) 
installed) by selecting the main ‘TV’ option. 

To make TV recordings, you'll need to create a 
recordings folder on a connected USB stick or hard 
drive - navigate to it in File Manager, right-click, 
and select ‘Make new folder’). Then, in the web 
interface on a remote computer, go to Configuration 
> Recordings and set the recording system path to 
var/media/lyour_drive_namel]l/recordings. 


Live viewing 


The live TV stream 
can be accessed 
in many ways, 
including Android 
and iOS apps. 
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Evans 


PJ is a writer, 
developer, and 
runs the Milton 
Keynes Jam. He 
is worryingly 
passionate about 
switching things 
on and off. 


mrpjevans.com 


You'll Need 


> 2x 433MHz 
transceivers 
magpi.cc/yXnbtu 


> 2x Mini 
breadboards 
magpi.cc/QEyLck 


> 12 x M/F 
jumper leads 
magpi.cc/UgGBxg 


>» RF mains socket kit 
magpi.cc/vuCjwL 


> Here's everything 
you need. It is 
possible to just use 
one Raspberry Pi, 
but double up for 
more fun 


Build a secret 
radio chat device 


Add a cheap 433MHz radio to your Raspberry Pi to send wireless 
messages without WIFI and operate remote-control main sockets 


only option for wireless communication 

on the Raspberry Pie What if there isn’t 
a network available or you need a longer range? 
433MHz radio is where you want to be. In this 
tutorial we’ll add this capability to a pair of Pi 
boards and show how to send wireless messages 
from one to the other with no WiFi network. Then, 
we’ ll increase the range with a touch of science and 
Start talking to RF-based switchable main sockets. 
Have Pi-controlled sockets all around the house! 


GC ure, WiFi is all well and good, but is it the 


Prepare your Pi boards 

To demonstrate sending messages using 
433MHz, it makes sense to use two Raspberry Pi 
boards so we can have a conversation. None of 
what we’re doing here requires much processing 
power, so any Pi will do, even original Model As or 
Bs. Depending on what you’re comfortable with, 
install either full Raspbian Stretch, or — as we’re 
doing here — Raspbian Lite, as everything will 

be run from the command line. If you haven’t 
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got access to multiple monitors and keyboards, 
consider using SSH to access each Pi with two 
windows on your main computer. That way you 
can see everything taking place. 


Meet the transceivers 

Each kit comes with two circuit boards. The 
longer of the two boards is the receiver, sporting 
four pins. Before wiring up, check the labelling 
of these pins very carefully as they do sometimes 
vary. Regardless of position, there will be 5 V power 
in (labelled VCC), ground (GND), and two ‘DATA’ 
lines which transmit the received signals. These 
are identical so you can use either. 

The smaller transmitter has three lines, 

which again can vary in position based on the 
manufacturer. Just like the receiver, you have VCC 
for power, GND for ground, and this time, a single 
data line. 


Wire-up the breadboard 

We’re using a tiny breadboard, but any size 
will work. In fact, a larger board with power and 
eround rails might be a bit tidier. Carefully insert 

a receiver and transmitter in each breadboard 
alongside each other. We want the two breadboards 
opposite so that the transmitter of Pi #1 (which we’re 
calling ‘Alice’) is pointing directly at the receiver of 
Pi #2 (‘Bob’) and vice versa. 

Connect six jumper leads to each breadboard, 
one on the rail for each pin of the transceiver pair. 
It doesn’t matter which ‘DATA’ line you use on 
the receiver. 


Initially, the two Pi boards 
must be really close 

to communicate. We'll 
increase the range later 


Connect to the Pi boards 

Connect each Pi to its six jumper leads. 
Luckily, this project doesn’t require any additional 
components, so you can wire directly. Both the 
receiver and transmitter run at 5V, so connect 
each VCC jumper lead to physical pins 2 and 4 of 
the GPIO (the top two right-hand pins when pin 1 
is top-left). Next, connect the GND leads to pins 

6 and 9. Although your radio is now powered, it’s 
not much use if it can’t send and receive data, so 
connect the transmitter’s DATA to GPIO17 and the 
receiver’s DATA to GPIO27 (pins 11 and 13). 


Test receive 

Before we can do anything with our newly 
installed radio, we need some software. Open up a 
Terminal and issue the following commands: 


cd 

sudo apt install python3-pip git 

pip3 install rpi-rf 

git clone https://github.com/mrpjevans/ 
rfchat.git 


You now have everything installed to test your 
hardware. Pick your favourite of the two Raspberry 
Pi boards and enter the following: 


cd ~/rfchat 
python3 receive.py 


Now hold the remote control from the RF kit 
very close to the receiver and press its buttons. See 
numbers appear? Great. If not, review your wiring. 
Press CTRL+C to quit and repeat on the other Pi. 


The 433MHz receiver and 
transceiver come as a pair 
of small PCBs 


Test send 

Position the Raspberry Pi boards so the two 
breadboards are within a centimetre of each other, 
with Alice’s transmitter pointing at Bob’s receiver 
and likewise the other way around. On Alice, start 
the receive script just as we did in the previous 
step. On Bob, enter the following in the Terminal: 


cd ~/rfchat 
python3 send.py 1234 


All being well, ‘1234’ should be displayed 
repeatedly on Alice’s screen. There’s no error 
correction, so it’s normal to see missing or corrupt 
characters. If it doesn’t look quite right, try again. 
Once you’re happy, reverse the test to confirm 
Bob’s receiver is also working. 
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<4 The pair of 
transceivers do not 
require any additional 
components and can 
be wired straight to 
the GPIO 
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~~ MdadPi 
i 


> The transceiver takes its 
5V power from the Pi, as 
well as the incoming and 


outgoing signals 


TUTORIAL 


07 Let’s have a chat 

Our two Raspberry Pi boards can now 
communicate wirelessly without WiFi. To 
demonstrate what’s possible, take a look at 
the rfchat.py script. This code uses threading 
(code-speak for doing multiple things at once) to 
monitor the keyboard and receiver for data. We 
convert incoming and outgoing data to numbers 
(ASCII) and back. The result is a live chat interface. 
You can now send and receive messages. To start: 


cd ~/rfchat 
python3 rfchat.py 


rfchat.py 


» Language: Python 3 


Q01. import sys Q19. 
Q@0@2. import tty Q20. 
003. import termios Q21. 
Q04. import threading Q22. 
Q05. import time Q23. 
Q06. from rpi_rf import RFDevice Q24. 
007. Q@25. 
008. # Elegant shutdown Q26. 
Q@09. def exithandler(): Q27. 
Q10. termios.tcsetattr(sys.stdin, termios. Q28. 
TCSADRAIN, old_ settings) Q@29. 
011. try: 930. 
Q12. rx.cleanup() Q31. 
Q13. tx.cleanup() Q32. 
014. except: 033. 
015. pass 034. 
Q16. sys.exit(@) 
Q17. Q35. 
018. # Activate our transmitter and received 036. 
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Now slowly type on either Pi and the message 
will appear on the other. In fact, your local output 
is your receiver picking up your own transmitter! 


Increasing range with science 
The reason for the radio’s poor range is 
the tiny antennas, but this can be fixed. The 
antenna’s length needs to be a harmonic of the 
wavelength, which is calculated by dividing the 
speed of light by the frequency (299 792.458 m/s 
divided by 433000000). You can keep dividing the 
result of 692.36mm by 2 until you get a sensible 
length. A173mm antenna is long enough to give 
an impressive range, normally covering a whole 
house. Solder 173 mm wires to all four ‘ANT’ 
solder points on the PCBs. Your rfchat should 
now work over long distances. 


Socket to me 

There are many household devices that 
use 433MHz to send control codes. Among the 
most popular are remote-control mains sockets, 


= RFDevice(17) 
-enable tx() 
= RFDevice(27) 
.enable_ rx() 


# Receiving loop 
def rec(rx): 


print(“Receiving” ) 
lastTime = None 
while True: 
currentTime = rx.rx_code timestamp 
if ( 
currentTime != lastTime and 


(lastTime is None or currentTime - 


lastTime > 350000) 


Ve 


lastTime = rx.rx_code_ timestamp 
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Al 


often used to switch lights. These commonly use 
433MHz and protocols that rpi-rf can understand. 


cd ~/rfchat 
python3 receive.py 


Press buttons on the remote control. You’re 
likely to see a list of numbers, repeating for error 
correction, that change with each button. Make a 
note of these and then send them out as follows: 


python3 send.py [number | 


You should hear a reassuring ‘click’ from the 
relay of the socket. Try switching it on or off. 


A Aclose look at the 
transceiver. The 
larger board is the 


Make it your own receiver and the 
smaller square 

These 433MHz units add a range of radio to deliver and receive any information. board transmits 

possibilities to your Raspberry Pi projects ata Now you can control sockets from your Raspberry 

very low cost. Not just home automation projects Pi, you can link these up to any kind of event 

with controllable sockets, but also providing radio you can imagine. How about detecting your car 

communication where WiFi isn’t practical, such as coming home using a Pi Camera Module and 

high-altitude ballooning or unusually positioned number-plate recognition, then switching on the 

sensors like flood monitors. IoT devices can use house lights? 


DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/mexmKh 


037. try: 055. 
038. it (fx.rx_ code == 13): Q@56. # Remember how the shell was set up so we can reset 
Q39. # Enter/Return Pressed on exit 
240. sys.stdout.write(‘\r\n’) Q@57. old settings = termios.tcgetattr(sys.stdin) 
Q41. else: Q58. tty.setraw(sys.stdin) 
Q42. sys.stdout.write(chr Q@59. 
(rx.rx_code) ) Q@6@. while True: 
043. sys.stdout.flush() Q61. 
044. except: Q62. # Wait for a keypress 
Q45. pass 063. char = sys.stdin.read(1) 
047. 064. 
048. time.sleep(@.@1) 65. # If CTRL-C, shutdown 
Q49. Q66. iT ord char) == 3¢ 
Q@50. # Start receiving thread Q67. exithandler() 
Q@51. t = threading. Thread(target=rec, 068. else: 
args=(rx,), daemon=True) Q69. # Transmit character 
Q@52. t.start() 70. tx.tx_code(ord(char) ) 
053. 071. 
Q@54. print(“Ready to transmit”) Q72. time.sleep(@.@1) 
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Pi Bakery: 
The Matr1x 


The Matrix is gn undedicated array of switches and lights 
that can be put to any number of uses - this month, 


let's do the final assembly 


the controller board. Now we see how to bring 
all the parts we have built so far together and 
see the basic functions come to life. 


ast month we completed the construction of 


Wiring up the LED boards 

We need to take the LED boards and 
add some wires so we can connect them to the 
controller board (Figure 1). While electricity 
doesn’t care what colour wires it flows through, 
it helps us enormously to connect them up to the 


Just the LED board 


= 


“wa” 


Complete mounted switch 
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right place. We used violet, blue, green, red, and 
orange wire for this (as shown in Figure 12 in the 
first part of this tutorial, issue 73). That is orange 
for the cathode, red for the red LED Ao, green for 
the green LED A1, blue for the blue LED A3, and 
finally violet for the switch pin SW. 


Getting the wires the right length 

We soldered one end of the wires to 
each wire reel and gathered the wires together 
(Figure 2). Then we pulled out a sufficient quantity 
of wire to reach the controller board from one of 
the matrix positions and snipped off all the wires. 
Remember that wires need to reach both sides 
of the controller board, so it’s better to make the 
wires too long rather than too short. Next, we took 
a battery tray and put a temporary sticky label on it 
with the matrix position number written on it, and 
finally passed the wires through the side slot. We 
repeated this for all matrix positions. 


A. Figure 2 Attaching all five 
wires to the LED board 
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! You'll Need 


> 2 x 40-way IDC 
connectors 
magpi.cc/MLBnKF 


>» 600 mm of 40-way 
ribbon cable 
magpi.cc/ysjGdR 


> Red, green, 
blue, orange, 
and violet wire 
magpi.cc/QNcPdi 


V_ Figure 3 The 
schematic of the 
matrix made from 
LED boards 


C2 C4 C6 


4 Figure 1 Setting up 
your workspace 


Module O Module 1 Module 2 Module 3 


seg d Seg d Sega 
Seg b Seg b Seg b 
seg c seg Cc Seg c 
sege seg e Seg e 
Seg f Seg f Seg f 
Seg g Seg g seg g 
Sega Sega seg d 
Seg D Seg b Seg b 
Seg C Seg C Seg c 
sege Seg e Sege 
Seg f Seg f Seg f 
Seg g Segg 9eg g 
a) 

co) 

=I 

= 
re i ee ee ee 
ae 
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The matrix circuit 

The LED boards are wired up to the 
controller to form the matrix, this is shown in 
Figure 3. Each numbered module is an LED board 
(whose schematic was shown in Figure 11 in 
the first part of this tutorial, issue 73), and the 
connections out of this diagram — Co to C7, SWo 
to SW15, and Seg a to Seg g, — go to the controller 
board schematic (Figure 6 in part two of this 
tutorial, issue 74). These three schematics form 
what is known as a hierarchical schematic, where 
ae gee yee a complex section of circuit is drawn as a block and 
; a. that block has a schematic showing its circuitry. 
In this case there are three levels of hierarchy. 


“=, 


7 
4 
Rtatatn ; # 


Y/ 


ff 


Figure 4 Wiring the 
first LED position to 1 
the control board a) wp 


Control Board 


Cathode 0 

Pin 2 

Cathode 2 Starting the wiring 

ae Place the controller board on the back of the 
chs . tray next to the slot in the side at matrix position 11, 
Cathode 6 and draw a line round it for reference. Then take the 
Pin5 LED tray for position 10 and feed the wires through 
the hole in the board and clip the battery tray to the 
base on the front. Next, connect the five wires up to 


the controller board, as shown in Figure 4. We then 


Cathode 1 

sth A : added all the other LED modules and pulled the 
eaenades wires through the holes, without wiring them up so 
Pin7 we weren’t forever turning the box over. 


Cathode 5 
Pin 10 
Cathode 7 
Pin 8 

Complete the wiring 

Stand the lid of the box on four blocks so 
the LEDs are not being crushed by the bench. 
Then concentrate on one colour wire at a time; 
i.e. wire up all the red wires from each LED to the 
control board, then the blue and so on. They all 
go to one of two places on the control board, with 
the exception of the violet switch wires: these go 
to different GPIO pins on the ribbon cable header. 
Figures 5 to 9 show the wiring for each individual 
Segment e LED wire. Note that the control board has been 
separated for clarity. 


Segment a 


seonenrao | TOP TIP 


Attaching wires to the LED boards 


We used a reel of solder as a weight to anchor the 
segment e wires to the bench, and some snipe-nose pliers to 
prevent the LED boards from flipping over while 
soldering the wires. 


Figure 6 The red segment a & e wires 
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Top Tip 
Remember the special one 


Matrix position 11 has the wire entry hole in a different 
place to the others, so that it does not come up 
underneath the control board. 


Attaching the matrix to the Pi 


To attach the Matrix to the Pi, we use 
two 40-way IDCs (insulation displacement 
connectors) and an approximately 600 mm 
length of 40-way ribbon cable. Line up the 
cable in the connector, with the arrow on 
the left-hand side pointing towards the red 
conductor. Then tighten the vice up slowly until 
the connectors pierce the cable completely 
(Figure 10, overleaf). Crimp up the other end 
of the cable, and make sure the connectors are 
placed as seen in Figure 11 (overleaf). Finally, 
loop the cable over itself at the Pi end and fit a 
strain-relief clip if you have one. 


Testing the circuit 

Let’s test the hardware. Type in and run the 
code in Matrix_test.py. This will, at first, turn on 
the red LED of each switch. Pressing that switch 
will turn the LED green; press again for a blue. The 
final press will turn all the LEDs on that switch off. 
A printout is given when any switch is changed. 
If this does not happen then check the control 
board for short circuits and the wiring for correct 
routing. Note, at this stage sometimes the LEDs 
will randomly toggle while the Pi is busy — we will 
fix that later in the final code. 


Fixing the LED boards 

The LED boards need to be fastened down, 
to prevent the wires pushing them up and stopping 
the switches from operating correctly. We found 
the best way was to use a small amount of hot- 
melt glue. Remove the labels in the battery tray, 
align the LED boards with the reflector, then apply 
a small round dab of hot-melt glue to the bottom 
of the LED board, and quickly push it into place, 
using the reflector to ensure it is lined up with the 
reflector pegs on the battery case. 


Figure 9 The violet switch wires 
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Control Board 


Segment b 


Segment f 


Segment b 


Segment f 


Segment c 


Segment g 


Segment c 


Segment g 


GPIO 12 
GPIO 25 
GPIO 24 
GPIO 23 


GPIO 6 
GPIO 13 
GPIO 19 
GPIO 26 


GPIO 16 
GPIO 20 
GPIO 21 
GPIO 4 


GPIO 17 
GPIO 27 
GPIO 22 
GPIO 5 
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Figure 10 
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% Figure 10 Crimping 
the ribbon cable to 
the connector 


A Figure 11 
The final cable 


> Figure 12 Removing 
the switch pips 
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Final assembly 

We found that when the cover, lens, and 
reflector were placed over the LED, there was not 
enough travel to make the switch turn on and off 
reliably due to the wires on the underside of the 
LED board. So we increased the travel on the switch 
by removing the small raised part on the back 
of the reflector with a flat-ended router bit. You 
can use either a pillar drill with the router in the 
chuck, a hand-held drill or Dremel, or you can use 
a scalpel. Figure 12 shows the three stages of this 
process: before, during, and after. 


With the hardware tested and working, next month 
we will see how to adapt our test code, and make 

it into a fully-fledged Python library. Then we will 
Start to use that library to put our Matrix to work. {!/ 


Matrix_test.py 


001. 
002. 
003. 
004. 


905. 


006. 


007. 


008. 


99. 


010. 


G11. 
Q12. 
013. 
014. 
Q15. 
016. 
017. 
018. 
O19. 
020. 
Q21. 
Q22. 
Q23. 
024. 
Q25. 
026. 


Q27. 
028. 


O29. 


030. 


import time 
import RPi.GPIO as io 


dataPin = 14 ; clockPin = 15 ; 
loadPin = 18 ; buttons = @ ; 
oldButtons = 0 

buttonPins = [12,25,24,23,6,13,19,26, 
16,20,21,4,17,27,22,5] # rows 
ledsState = [ 0,0,0,0,0, 
0,0,0,0,0,0,0,0,0,0,0] 

#0=off , 1=red, 2=green, 3=blue 

ledCol = [0,64,32,16,0,4,2,1] 

# LED colour number 

register = [0,0,0,0,0,0,0,0,0] 

# copy of the Max chip's registers 
address = [253,55 7;, 133,557; 
2,4,6,8, 2,4,6,8] # switch number to 
register address 

colOff = [0,0,0,0, 4,4,4,4, 
0,0,0,0, 4,4,4,4] # colour offset per 
Switch 


def main(): 
global register 
print("Matrix test") 
init_io() 
init_max7219() 
time.sleep(0.04) 
clrLED() 
readButtons() 
for switch in range(@,16): 
setLed(switch, ledsState[ switch] ) 
while True: 
for switch in range (0,16): 
readButtons() 
if buttonsChanged : 
print("Bit pattern", 
fullBin(buttons), 
" Number =",buttons, ) 
for switch in range(@,16): 
if buttons & (1 << 
Switch) != oldButtons & 
(1 << switch) : 
print ( 
"changing switch number", switch) 
setLed(switch, 
ledsState[ switch] ) 


Q31. 


time.sleep(0.2) 


932. 


Q33 


934. 
Q35. 
936. 
Q37. 
038. 
939. 
040. 
041. 
042. 
043. 


044. 


. def setLed(switch,col): # increment LED state & 
display 
global register 
reg = address[ switch] 
ledsState[switch] += 1 
if ledsState[switch] >3 : 
ledsState[switch] = @ 
if colOff[switch] == 
register[reg] &= 
else: 
register[reg] &= 
register[reg] |= 
ledCol[colOff[ switch ]+ledsState[ switch] | 
sendMax(address[switch],register[reg ] ) 


OxOF # clear bottom bits 


@xF@ # clear top bits 


045. 


046. 
Q47. 
048. 
Q49. 
Q50. 
Q51. 
Q52. 
Q53. 


def fullBin(num): # to show all leading zeros 
binary = °° 
for i in range(15,-1,-1): 
if num & (1 << i): 
binary = binary +°1° 
else: 
binary = binary +'0" 
return binary 


Q54. 


Q55. 
Q56. 
Q57. 
058. 
Q59. 


060. 
061. 
062. 
063. 
064. 
Q65. 


def init_io(): 

io.setmode(io.BCM) 

io.setwarnings(False) 

for i in range (@, len(buttonPins) ): 
io.setup(buttonPins[i], io.IN, 

pull _up down=io.PUD_UP) 
io.setup(dataPin, io.OUT) # data out 
io.output(dataPin, @) 
io.setup(clockPin, io.OUT) # clock 
io.output(clockPin, @) 
io.setup(loadPin, io.OUT) # not load 
io.output(loadPin, 1) 


066. 


067. 
068. 
069. 
970. 
Q71. 
Q72. 
073. 


def readButtons(): 
global buttons, buttonsChanged, oldButtons 
buttonsChanged = False 
oldButtons = buttons 
newBut = @ 
for i in range (@, len(buttonPins) ): 
edge = io.wait for _edge(buttonPins[i], 
io. FALLING, 1,2) 


074. 
Q75. 


076. 
O77. 
078. 


Q79. 
080. 
081. 
082. 
083. 
084. 
985. 
086. 
087. 
088. 
089. 
990. 
Q91. 
992. 
993. 


994. 
995. 
996. 


097. 
998. 
999. 
100. 
101. 
102. 
103. 
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DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/1NqJjmV 


if edge == None: 
newBut &= OXxFFFF “* (1<< i) # clear bit in 
variable 
else: 
newBut |= 1<< i # set bit in variable 
if newBut != buttons : # we have a changed from 
last time 
buttons = newBut 


buttonsChanged = True 


def clrLED(): 
for add in range(1,9): # all display registers 


sendMax (add, @) 
def init_max7219(): 
sendMax(@x9,@) # no decode 
sendMax (xB, 7) # scan all digits 
sendMax(@xA,@x15) # maximum intensity 
sendMax(@xC,1) # take out of shutdown mode 
def sendMax(add,data): # send a byte to mux chip 
package = add << 8 | data # join into one bit 
pattern 


io.output(loadPin, @) # lower load 
for i in range(15,-1,-1): # from 15 to @ 
io.output(dataPin, 1 & (package >> i)) # send 
MSB first 
io.output(clockPin, 1) # toggel clock 
io.output(clockPin, @) 
io.output(loadPin, 1) # latch value 


# Main program logic: 
if _name_ ==‘ main _': 


Start with issue 73 


This is the latest instalment in a series of Mike's Pi 
Bakery tutorials. You can download digital editions 
of previous tutorials for free. Start with The MagPi #73. 


magpi.cc/73 


be 


cs fe 
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@mindexplorers 


You'll Need 


>» An image 
manipulation 
program such 
as GIMP, or 
images from 
magpi.cc/mYSswY 


>» The latest version 
of Pygame 
Zero (1.2) 


>» The Audacity 
sound editor or 
similar or Sounds 
available from 
magpi.cc/mYSswY 


> Speakers or 
headphones 


Pygame Zero 
Invaders I] 


Space Invaders must be the first computer game that springs to mind 
for g lot of people. Here in part two we will take our basic game from 


part one and add all the extras 


our Space Invaders game with our player ship 

controlled by the keyboard, defence bases, the 
aliens moving backwards and forwards across the 
screen, and lasers flying everywhere. In this part 
we will add lives and levels to the game, introduce 
a bonus alien, code a leader board for high scores, 
and add some groovy sound effects. We may even 
eet round to adding an introduction screen if we 
get time. We are going to start from where we left 
off in part one. If you don’t have the part one code 
and files, you can download them from GitHub 
at magpi.cc/JxQrdd. 


n part one, last issue, we set up the basics for 


Introduction screen 
with input field for 
player's name 


PYGAME ZERO INVADERS 


Type your name then 
press Enter to start 
(arrow keys move, space to fire) 


If the player shoots all the aliens, 


they move on to the next level 
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The player has three lives 
at the start of the game 


A bonus or ‘boss’ alien 
appears from time to time 


You only live thrice 

It was a tradition with Space Invaders to be 
given three lives at the start of the game. We can 
easily set up a place to keep track of our player 
lives by writing player.lives = 3 in our init() 
function. While we are in the init() function, let’s 
add a player name variable with player.name = "" 
so that we can show names on our leader board, but 
we’ll come to that in a bit. To display the number of 
lives our player has, we can add drawLives() to our 
draw() function and then define our drawLives() 
function containing a loop which ‘blits’ life.png 
once for each life in the top left of the screen. 


ORES CORES 


Escape to play again 


Scores from previous 
games are listed on the 


leader-board screen 


Life after death 


Now we have a counter for how many lives 
the player has, we will need to write some code to 
deal with what happens when a life is lost. In part 
one we ended the game when the player.status 
reached 30. In our update() function we already 
have a condition to check the player.status and 
if there are any aliens still alive. Where we have 
written if player.status == 30: wecan write 
player.lives -=1. Wecan also check to see if the 
player has run out of lives when we check to see if 
the RETURN (aka ENTER) key is pressed. 


Keep calm and carry on 

Once we have reduced player. lives by 
one and the player has pressed the RETURN key, 
all we need to do to set things back in motion is to 
set player.status = @. We may want to reset the 
laser list too, because if the player was hit by a flurry 
of lasers we may find that several lives are lost 
without giving the player a chance to get out of the 
way of subsequent lasers. We can do this by writing 
lasers = []. Ifthe player has run out of lives at 
this point, we will send them off to the leader-board 
page. See figure1.py to examine the code for dealing 
with lives. 


On the level 

The idea of having levels is to start the game 
in an easy mode; then, when the player has shot all 
the aliens, we make a new level which is a bit harder 
than the last. In this case we are going to tweak a 
few variables to make each level more difficult. To 
Start, we can set up a global variable level = 1in 
our init() function. Now we can use our level 
variable to alter things as we increase the value. 
Let’s start by speeding up how quickly the aliens 
move down the screen as the level goes up. When 
we calculate the movey value in updateAliens(), 
we can write movey = 40 + (5*level) on the 
condition that moveSequence is 10 or 30. 


On the up 

To go from one level to the next, the player 
will need to shoot all the aliens. We can tell if 
there are any aliens left if len(aliens) = @. So, 
with that in mind, we can put a condition in our 
draw() function with if len(aliens) == @: and 


figurel.py 


Q@01. def draw() 
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QQ@2. # additional drawing code 
Q@3. drawLives() 
204. if player.status >= 30: 
Q@5. if player.lives > @: 
Q06. drawCentreText ( 
"YOU WERE HIT!\nPress Enter to re-spawn") 
007. else: 
008. drawCentreText ( 
"GAME OVER! \nPress Enter to continue") 
209. 
Q@10. def init(): 
Q11. # additional player variables 
Q12. player.lives = 3 
Q13. player.name = '" 
Q14. 
Q@15. def drawLives(): 
016. for 1 in range(player.lives): 
Q17. screen.blit("life", (10+(1*32),10)) 
Q18. 
Q@19. def update(): 
Q20. # additional code for life handling 
Q21. global player, lasers 
Q22. if player.status < 30 and len(aliens) > @: 
Q23. if player.status > @: 
Q24. player.status += 1 
Q@25. if player.status == 30: 
Q26. player.lives -= 1 
Q27. else: 
Q28. if keyboard.RETURN: 
Q@29. if player.lives > @: 
030. player.status = @ 
Q31. lasers = [] 
Q32. else: 
Q33. # go to the leader-board 
034. pass; 
Q35. 


Q@36. def drawCentreText(t): 


037. screen.draw.text(t , center=(400, 300), owidth=0.5, 
ocolor=(255,255,255), color=(255,64,0) , fontsize=60) 


then draw text on the screen to say that the level 
has been cleared. We can put the same condition 
in the section of the update() function where 

we are waiting for RETURN to be pressed. When 
RETURN is pressed and the length of the aliens list 
is O, we can add 1 to level and call initAliens() 
and initBases() to set things ready to start the 
new level. 


A Code to deal 
with player 
lives. Notice the 
drawCentreText() 
function to short-cut 
printing text to the 
centre of the screen 
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figure2.py 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
Q11. 
O12. 
013. 
014. 


Q15. 
016. 
017. 
018. 
O19. 
Q20. 
Q21. 
Q22. 


A Code to update the 
boss or bonus alien. 
This code runs when 
the boss is active 
or uses random 
numbers to see if it’s 
time to make it active 


def updateBoss(): 
global boss, level, player, lasers 
if boss.active: 
boss.y += (@.3*level) 
if boss.direction == @: boss.x -= (1* level) 
else: boss.x += (1* level) 
if boss.x < 100: boss.direction = 1 
if boss.x > 700: boss.direction = @ 
if boss.y > 50Q: 
sounds.explosion.play() 
player.status = 1 
boss.active = False 
if randint(@, 30) == 
lasers.append(Actor("laser1", 
(boss.x,boss.y))) 
lasers[len(lasers)-1].status = 0 
lasers[len(lasers)-1].type = @ 
else: 
if randint(@, 800) == 
boss.active = True 
boss.x = 800 
boss.y = 100 
boss.direction = 0 


Front and centre 

You may have noticed in figure1.py 
that we made a couple of calls to a function 
called drawCentreText() which we have not 
yet discussed. All that this function does is to 
shorten the process of writing text to the centre 
of the screen. We assume that the text will be 
positioned at coordinates (400, 300) and will 
have a set of standard style settings and colours, 
and the function definition just contains one 
line: screen.draw.text(t , center=(400, 
300), owidth=0.5, ocolor=(255,255,255), 
color=(255,64,0), fontsize=6@) —- where t is 
passed into the function as a parameter. 


07 Flying like a boss 

To liven up our game a little bit, we are 
going to add in a bonus or boss alien. This could 
be triggered in various ways, but in this case we 
will start the boss activity with a random number. 
First we will need to create the boss actor. Because 
there will only ever be one boss alien on screen at 
any time, we can just use one actor created near 
the start of our code. In this case we don’t need to 
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Press Enter to re-epawn 


A Lasers can be very bad for your health. Best to avoid them 


give it coordinates as we will start the game with 
the boss actor not being drawn. We write boss = 
Actor("boss"). 


Keeping the boss in the loop 

We want to start the game with the boss 
not being displayed, so we can add to our init() 
function boss.active = False and then in our 
draw() functionif boss.active: boss.draw(), 
which will mean the boss will not be drawn until 
we make it active. In our update() function, along 
with our other functions to update elements, 
we can call updateBoss(). This function will 
update the coordinates of the boss actor if it is 
active or, if it is not, check to see if we need to 
start a new boss flying. See figure2.py for the 
updateBoss() function. 


Did you hear that? 


You may have noticed that in figure2.py 
we have an element of Pygame Zero that we have 
not discussed yet, and that is sound. If we write 
sounds.explosion.play(), then the sound file 
located at sounds/explosion.wav will be played. 
There are many free sound effects for games on the 
internet. If you use a downloaded WAV file, make 
sure that it is fairly small. You can edit WAV sound 
files with programs like Audacity. We can add 
sound code to other events in the program in the 
Same way, like when a laser is fired. 


More about the boss 

Staying with figure2.py, note how we can 
use random numbers to decide when the boss 
becomes active and also when the boss fires 
a laser. You can change the parameters of the 
randint() function to alter the occurrence of these 


events. You can also see that we have a simple path 
calculating system for the boss to make it move 
diagonally down the screen. We use the level 
variable to alter aspects of the movement. We treat 
the boss lasers in the same way as the normal alien 
lasers, but we need to have a check to see if the 
boss is hit by a player laser. We do this by adding a 
check to our checkPlayerLaserHit() function. 


Three strikes and you're out 

In the previous episode, the game ended if 
you were hit by a laser. In this version we have three 
chances before the game ends, and when it does, we 
want to display a high score table or leader board to 
be updated from one player to the next. There are a 
few considerations to think about here. We need a 
separate screen for our leader board; we need to get 
players to enter their name to put against each score 
and we will have to save the score information. 
In other programs in this series we have used the 
variable gameStatus to control different screens, 
so let’s bring that back for this program. 


Screen switching with 

gameStatus 
We will need three states for the gameStatus 
variable. If it is set to o then we should display an 
intro screen where we can get the player to type 
in their name. If it is set to 1 then we want to run 
code for playing the game. And if it is set to 2 then 
we display the leader-board page. Let’s first deal 
with the intro screen. Having set our variable to 0 
at the top of the code, we need to add a condition to 
our draw() function: if gameStatus == @:. Then, 
under that, use drawCentreText() to show some 
intro text and display the player.name string. To 
Start with, player.name will be blank. 


A name is just gd name 

Now to respond to the player typing their 
name into the intro screen. We will write a very 
simple input routine and put it in the built-in 
Pygame Zero function on_key_down(). figure3.py 
shows how we do this. With this code, if the 
player presses a key, the name of the Key is added 
to the player.name string unless the key is the 
BACKSPACE key, in which case we remove the last 
character. Notice the rather cunning way of doing 


figure3.py 


Q@01. def on_key_down(key): 
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QQ@2. global player 

003. if gameStatus == @ and key.name != "RETURN": 
004. if len(key.name) == 1: 

Q05. player.name += key.name 

006. else: 

007. if key.name == “BACKSPACE": 

008. player.name = player.name[:-1] 


that with player.name = player.name[:-1]. We 
also ignore the RETURN key, as we can deal with 
that in our update() function. 


Game on 

When the player has entered their name 
on the intro screen, all we need to do is detect a 
press of the RETURN key in our update() function 
and we can switch to the game part. We can easily 
do this by just writing if gameStatus == 
and then under that, if keyboard.RETURN and 
player.name != "": gameStatus = 1. We will 
also now need to put our main game update code 
under acondition, if gameStatus == 1:. We will 
also need to have the same condition in the draw() 
function. Once this is done, we have a system for 
switching from intro screen to game screen. 


Leader of the pack 


So now we come to our leader-board screen. 


It will be triggered when the player loses the third 
life. When that happens, we set gameStatus to 2 
and put a condition in our draw() and update() 
functions to react to that. When we switch to our 
leader board, we need to display the high score 
list — So, we can write in our draw() function: 

if gameStatus == 2: drawHighScore(). Going 
back to figure1.py, you’ll see that we left a section 
at the end commented out, ready for the leader 
board. We can now fill this in with some code. 


If only | learned to read and write 


We are going to save all our scores ina 
file so that we can get them back each time the 


A Code for capturing 


keyboard input for 
the player to Input 
their name on the 


introduction screen 


Start with 
issue 71 


This is the latest 
instalment 

in a series of 
Pygame Zero 
tutorials. You 
can download 
digital editions 
of previous 
tutorials for free. 
Start with The 
MagPi #71. 


magpi.cc/71 
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figure4.py 


Q@@1. def readHighScore(): 

002. global highScore, score, player 

003. highScore = [] 

004. ey: 

05. hsFile = open("highscores.txt", "r") 

Q06. for line in hsFile: 

07. highScore.append(line.rstrip() ) 

008. except: 

009. pass 

Q18. highScore.append(str(score)+ “ " + player.name) 

Q11. highScore.sort(key=natural_key, reverse=True) 

Q12. 

Q@13. def natural _key(string ): 

Q14. return [int(s) if s.isdigit() else s for s in 
re.split(r'(\d+)', string _)] 

Q15. 

Q@16. def writeHighScore(): 

Q17. global highScore 

Q18. hsFile = open("highscores.txt", "w") 

Q19. for line in highScore: 

Q20. hsFile.write(line + "\n") 

Q@21. 

Q@22. def drawHighScore(): 

Q23. global highScore 

924. y = @ 

Q@25. screen.draw.text("TOP SCORES", midtop=(400, 30), 
owidth=0.5, ocolor=(255, 255,255), color=(0,64,255) , 
fontsize=60) 

Q26. for line in highScore: 

Q27. if y < 400: 

Q28. screen.draw.text(line, midtop=(400, 100@+y), 
owidthn=0.5,. ecolor=(0,0,255),. color=(255, 255,08) 
fontsize=5@) 

Q29. y += 50 

Q30. screen.draw.text("Press Escape to play again" , 


center=(400, 550), owidth=0.5, ocolor=(255,255,255), 
color=(255,64,0) , fontsize=60) 


A Code for reading, 
writing, sorting, and 
drawing the high 
score leader board 


game is played. We can use a Simple text file for 
this. When a new score is available, we will have 
to read the old score list in, add our new score to 
the list, sort the scores into the correct order, and 
then save the scores back out to create an updated 
file. So, the code we need to write in our update() 
function will be to call a readHighScore() 
function, set our gameStatus to 2, andcalla 
writeHighScore() function. 
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Press Enter to go to the next level 


A Allthe aliens have been destroyed. It’s time to move up a level 


Functions need to function 

We have named three functions that 

need writing in the last couple of steps: 
drawHighScore(), readHighScore(), and 
writeHighScore().Have a look at figure4.py to see 
the code that we need in these functions. The file 
reading and writing are standard Python functions. 
When reading, we create a list of entries and 

add each line to a list. We then sort the list into 
highest-score-first order. When we write the file, 
we just write each list item to the file. To draw the 
leader board, we just run through the high-score 
list that we have sorted and draw the lines of text 
to the screen. 


17 


Sort it out 


It’s worth mentioning the way we are 
sorting the high scores. In figure4.py we are 
adding a key sorting method to the list sorting 
function. We do this because the list is a string 
but we want to sort by the high score, which is 
numerical, so we break up the string and convert 
it to an integer and sort based on that value rather 
than the string. If we didn’t do this and sorted as 
a string then all the scores starting with 9 would 
come first, then all the 8s, then all the 7s and so 
on, with 9000 being shown before 80000, which 
would be wrong. 


Well, that’s all folks 


That’s about all we need for our Pygame 
Zero Invaders game other than all the additions 
that you could make to it. For example, you could 
have different graphics for each row of aliens. 
We’re sure you can improve on the sounds that 
we have supplied, and there are many ways that 
the level variable can be worked into the code 
to make the different levels more difficult or 
more varied. {i 
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001. 
002. 
003. 
004. 
905. 
006. 
007. 
008. 
009. 
010. 
011. 


912. 


013. 
014. 


O15. 
016. 
Q17. 
018. 
Q19. 
920. 


Q21. 


Q22. 
Q23. 
Q24. 
025% 


Q26. 
Q27. 


028. 
Q29. 


930. 


O31), 
Q32. 
0334 
034. 


Q35. 
036. 
Q37. 


import pgzrun, math, re, time 

from random import randint 

player = Actor("player", (400, 550)) 
boss = Actor("boss") 

gameStatus = @ 

highScore = [] 


def draw(): # Pygame Zero draw function 
screen.blit('background', (@, @)) 
if gameStatus == @: # display the title page 
drawCentreText("PYGAME ZERO INVADERS\n\n\ 
nType your name then\npress Enter to start\n(arrow 
keys move, space to fire)") 
screen.draw.text(player.name , 
center=(400, 500), owidth=0.5, ocolor=(255,0,@), 
color=(@,64,255) , fontsize=60) 
if gameStatus == 1: # playing the game 
player.image = 
player.images[math.floor(player.status/6) ] 
player.draw() 
if boss.active: boss.draw() 
drawLasers() 
drawAliens() 
drawBases() 
screen.draw.text(str(score) , 
topright=(780, 10), owidth=0.5, 
ocolor=(255,255,255), color=(0,64,255) , 
fontsize=60) 
screen.draw.text("LEVEL " + 
str(level) , midtop=(400, 10), owidth=0.5, 
Ocolor=(255, 255, 255), color=(0, 64,255). 
Ffontsize=60) 
drawLives() 
if player.status >= 30: 
if player.lives > @: 
drawCentreText( 
"YOU WERE HIT! \nPress Enter to re-spawn") 
else: 
drawCentreText( 
"GAME OVER! \nPress Enter to continue") 
if len(aliens) == 
drawCentreText( "LEVEL CLEARED! \nPress 
Enter to go to the next level") 
if gameStatus == 2: # game over show the 
leaderboard 
drawHighScore() 


def drawCentreText(t): 

screen.draw.text(t , center=(400, 300), 
owidth=0.5, ocolor=(255, 255,255), color=(255,64,0) 
» fontsize=60) 


def update(): # Pygame Zero update function 
global moveCounter, player, gameStatus, 
lasers, level, boss 


038. 
939. 
040. 
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045. 
046. 
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049. 
Q50. 
Q51. 
Q52. 
953. 
954. 
Q55. 
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Q57. 
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Q79. 
080. 
081. 
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088. 
089. 
990. 
991. 


THE FULL CODE: 


if gameStatus == 
if keyboard.RETURN and player.name != 
gameStatus = 1 
if gameStatus == 
if player.status < 30 and len(aliens) > 0: 
checkKeys() 
updateLasers() 
updateBoss() 
if moveCounter = 
moveCounter += 1 
if moveCounter == moveDelay: 
moveCounter = @ 
if player.status > 0: 
player.status += 1 
if player.status == 30: 
player.lives -= 1 


= @: updateAliens() 


else: 
if keyboard.RETURN: 
if player.lives > @: 
player.status = 0 
lasers = [] 
if len(aliens) == @: 
level += 1 
boss.active = False 
initAliens() 
initBases() 
else: 
readHighScore() 
gameStatus = 2 
writeHighScore() 
if gameStatus == 
if keyboard.ESCAPE: 
init() 
gameStatus = @ 


def on_key_down(key): 
global player 
if gameStatus == @ and key.name != "RETURN": 
if len(key.name) == 1: 
player.name += key.name 
else: 
if key.name == "BACKSPACE": 
player.name = player.name[:-1] 


def readHighScore(): 
global highScore, score, player 
highScore = [] 
cry: 
hsFile = open("highscores.txt", "r") 
for line in hsFile: 
highScore. append(line.rstrip()) 
except: 
pass 
highScore.append(str(score)+ " “ + 
player.name) 
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092. 
993. 
994. 
Q95. 


096. 
097. 
998. 
099. 
100. 
11s 
102. 
103. 
104. 
105. 
106. 


107. 
108. 
109. 
110. 
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13, 
114. 
115. 
116. 
i17. 
118. 
113, 
120. 
121. 
122, 
123. 
124. 
125. 
126. 
127. 
128. 
129, 
130. 
131. 
132. 
1335 
134. 
135. 
136. 
137 
138. 
139. 


140. 
141. 
142. 


highScore.sort(key=natural_key, reverse=True) 


def natural_key(string_): 
return [int(s) if s.isdigit() else s for s in 
re.split(r'(\d+)', string _)] 


def writeHighScore(): 
global highScore 
hsFile = open("highscores.txt", "w") 
for line in highScore: 
hsFile.write(line + “\n") 


def drawHighScore(): 
global highScore 
y= 0 
screen.draw.text("TOP SCORES", midtop= 
(400, 30), owidth=@.5, ocolor=(255,255,255), 
color=(@,64,255) , fontsize=6@) 
for line in highScore: 
if y < 400: 
screen.draw.text(line, midtop= 
(400, 100+y), owidth=0.5, ocolor=(0,0,255), 
color=(255,255,0) , fontsize=50) 
y += 50 
screen. draw. text ( 
"Press Escape to play again" , center= 
(400, 550), owidth=@.5, ocalor=(255,255,255), 
color=(255,64,0) , fontsize=6@) 


def drawLives(): 
for 1 in range(player.lives): 
screen.blit("life", (10+(1*32),10)) 


def drawAliens(): 
for a in range(len(aliens)): aliens[a].draw() 


def drawBases(): 
for b in range(len(bases) ): 
bases[b].drawClipped() 


def drawLasers(): 
for 1 in range(len(lasers)): lasers[1].draw() 


def checkKeys(): 
global player, score 
if keyboard.left: 
if player.x > 40: player.x -= 5 
if keyboard.right: 
if player.x < 760: player.x += 5 
if keyboard.space: 
if player.laserActive == 
sounds. gun.play() 
player.laserActive = 0 
clock.schedule(makeLaserActive, 1.0) 
lasers.append(Actor("laser2", 
(player.x,player.y-32))) 
lasers[len(lasers)-1].status = 
lasers[len(lasers)-1].type = 1 
score -= 100 


4) 
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def makeLaserActive(): 
global player 
player.laserActive = 1 


def checkBases(): 
for b in range(len(bases) ): 
if 1 < len(bases): 
if bases[b].height < 5: 
del bases[b| 


def updateLasers(): 
global lasers, aliens 
for 1 in range(len(lasers)): 
if lasers[1].type == 
lasers[1l].y += 2 
checkLaserHit(1) 
if lasers[l].y > 600: 
lasers[1].status = 1 
if lasers[1].type == 
lasers[1l].y -= 5 
checkPlayerLaserHit(1) 
if lasers[l].y < 10: 
lasers[1].status = 1 
lasers = listCleanup(lasers) 
aliens = listCleanup(aliens) 


def listCleanup(1): 
newList = [] 
for i in range(len(1)): 
if l[i].status == 
newList.append(1[i]) 
return newList 


def checkLaserHit(1): 
global player 
if player.collidepoint((lasers[1].x, 
lasers[1l].y)): 
sounds.explosion.play() 
player.status = 1 
lasers[1].status = 1 
for b in range(len(bases) ): 
if bases[b].collideLaser(lasers[1]): 
bases[b].height -= 10 
lasers[1].status = 1 


def checkPlayerLaserHit(1): 
global score, boss 
for b in range(len(bases) ): 
if bases[b].collideLaser(lasers[1]): 
lasers[1].status = 1 
for a in range(len(aliens)): 
if aliens[a].collidepoint((lasers[1].x, 
lasers[1l].y)): 
lasers[1].status 
aliens[a].status 
score += 1000 
if boss.active: 
if boss.collidepoint((lasers[1].x, 
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lasers[1].y)): 
lasers[1].status = 1 
boss.active = @ 
score += 5000 


def updateAliens(): 
global moveSequence, lasers, moveDelay 
movex = movey = @ 
if moveSequence < 10 or moveSequence > 320: 


movex = -15 

if moveSequence == 10 or moveSequence == 30: 
movey = 40 + (5*level) 
moveDelay -= 1 


if moveSequence >1@ and moveSequence < 320: 
movex = 15 
for a in range(len(aliens)): 
animate(aliens[a], pos=(aliens[a].x 
+ movex, aliens[a].y + movey), duration=@.5, 
tween='linear’' ) 
if randint(®, 1) == @: 
aliens[a].image = ‘alieni"” 
else: 
aliens[a].image = ‘“alienib” 
if randint(®, 5) == @: 
lasers.append(Actor("laser1", 
(aliens[a].x,aliens[a].y))) 
lasers[len(lasers)-1].status = 
lasers[ len(lasers)-1].type = 0 
sounds. laser.play() 
if aliens[a].y > 50@ and player.status == 
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sounds.explosion.play() 
player.status = 1 
player.lives = 1 

moveSequence +=1 

if moveSequence == 40: moveSequence = 0 


def updateBoss(): 
global boss, level, player, lasers 
if boss.active: 
boss.y += (@.3*level) 
if boss.direction == 
boss.x -= (1* level) 
else: boss.x += (1* level) 
if boss.x < 100: boss.direction 
if boss.x > 700: boss.direction 
if boss.y > 500: 
sounds.explosion.play() 
player.status = 1 
boss.active = False 
if randint(@, 30) == 
lasers.append(Actor("laser1", 
(boss.x,boss.y))) 
lasers[len(lasers)-1].status = @ 
lasers[ len(lasers)-1].type = @ 


| | 
OF 


else: 
if randint(@, 800) == @: 
boss.active = True 
boss.x = 800 
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boss.y = 100 
boss.direction = @ 


def init(): 

global lasers, score, player, moveSequence, 
moveCounter, moveDelay, level, boss 

initAliens() 

initBases() 

moveCounter = moveSequence = player.status = 
score = player.laserCountdown = @ 

lasers = [] 

moveDelay = 30 

boss.active = False 

player.images = 


["player", "explosion1", "explosion2","explosion3" 
"explosion4", "explosion5" ] 

player.laserActive = 1 

player.lives = 3 

player.name = °" 

level = 1 


def initAliens(): 
global aliens, moveCounter, moveSequence 
aliens = [] 
moveCounter = moveSequence = 9 
for a in range(18): 
aliens.append(Actor("alieni", (210+ 
(a % 6)*80,100+(int(a/6)*64)))) 
aliens[a].status = @ 


def drawClipped(self): 
screen.surface.blit(self. surf, (self.x-32, 
self.y-self .height+30), (0,0,64,self. height) ) 


def collideLaser(self, other): 
return ( 
self.x-20 < other.x+5 and 
self.y-self.height+3@ < other.y and 
self.x+32 > other.x+5 and 
self.y-self .height+30 + self.height > 
other.y 


) 


def initBases(): 
global bases 
bases = [] 
bc = @ 
for b in range(3): 
for p in range(3): 
bases.append(Actor("base1", 
midbottom=(150+(b*200)+(p*40) ,520))) 
bases[bc].drawClipped = 
drawClipped. set  (bases[bc]) 
bases[bc].collideLaser = 
collideLaser. get  (bases[bc]) 
bases[bc].height = 62 
bc +=1 


init() 
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DOWNLOAD 
THE FULL CODE: 


y,) magpi.cc/FSLBTf 


Coding games on the 
aspberry P1 in C/C++ 


Brian 
Beuken 


Very old game 
programmer, now 
teaching very young 
game programmers 
a lot of bad habits 
at Breda University 
of Applied Science, 
in the Netherlands. 


magpi.cc/YxaUVQ 


You'll Need 


>» Code::Blocks 
sudo apt-get 
codeblocks 


> GLM installed 
previously 


> stb_image.h 
installed previously 


But the future is 3D 


et’s make some use of those crazy matrices. 
We’ ve clearly demonstrated that we can 
avoid a lot of the crazy maths when working 
in 2D (see last issue’s guide) but though it’s 
Slightly overkill, using matrices gives us access to 
a lot more features and abilities. So let’s see how 
far we can push things. 


The third dimension 

We have really been working in 3D already; our 
tiles and sprites are in fact 3D, but only in the 
same way a drawing on a flat piece of paper is 3D. 
Also, we’ve been using a viewpoint or camera view 
that has been effectively placed directly above the 
paper — keeping our Z coordinate at zero has let 
our 3D system happily display in 2D. 

But what if we were to do a bit of origami on 
our paper and turn our flat paper into a nice cube? 
That’s more or less the principles of 3D. Well, 
then we have to make some decisions, such as 
“how is the cube placed in space?’, ‘on what axis 
or axes does it rotate around?’... If we look down 
on our cube and twiddle it about in our hand, we 
can see that different faces of the cube are visible 
at different times, and — also important to geta 
3D sense of depth with our eye — we notice that 
the points or vertices of the cube are at different 
distances to our eye. Hopefully we can get a sense 
that our cube points can be tracked on x, y, and z 
points ‘relative’ to our eye, or camera. 

Figure 1 shows how a 3D scene can be 
‘projected’ to a 2D flat space, due to being viewed 
relative to the camera. 
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Now consider what happens if you keep your 
head/eye perfectly still, and you move your 
cube up and to the left a bit. The cube is moving 
through space and, if our eye is still, it is moving 
off our screen, but we will maybe see a bit more of 
the faces on the front and right of the cube as it 
moves off. 

So, as you can see, that’s a bit complex. But 
wait, it gets worse: imagine this time that you 
hold the cube still, then move your head up 
slowly. In terms of your field of view, the cube 
is going to move down. Now imagine the cube 
rotating in your hand! 

So there are two ways to move the cube in our 
field of view. But what if we do both at the same 
time? Now we’ve got two things moving: the cube, 
rotating and translating in space, and our eye, 
which is also capable of rotating and translating 
in space. We start to get the idea that what we 
see in our field of view very much depends on the 
relative position of all the objects in our space. 
Also, we need to ignore things that we can’t see: 
if our cube is behind us, clearly we can’t see it. 

Now instead of our eye, our computer has to 
convert things in its idea of space, into images 
on our screen — or as we Call it, our ‘view plane’. 


TopTip & 


Learn to love matrices 


Matrices give us a way to transform any point 
in Space, and in many different ways. 


And that view of the world changes depending on 
where and how you view it (Figure 2, overleaf). 

The maths involved is frankly staggering, but 
with matrices there is a very simple way to work 
out where on a screen each of our cube’s eight 
corner points should be: 


Transformed Vertex = VxM 


Yup, just VxM, where V is the vertex and Misa 
transformation matrix. It’s true that there’s still 
a Massive amount of calculation going on under 
the hood, but we can be confident our maths 
library is handling that, and therefore we can view 
the concept in a simple, abstract way. It’s a bit 
like offering someone a meal without going into a 
long description of its constituents and how you 
prepared and presented them. 

We can simply multiply each vertex point 
by a matrix to get a new point, which is going 


MA great feature of matrices is that we 
can combine - or ‘concatenate' - them, 
by multiplying them in specific ways @ 


to represent a transformed point. The vertices 
might be different for each point, but the 

matrix is always the same. So computers, and 
GPUs especially, are designed to be effective at 
using and reusing this matrix and can calculate 
hundreds of thousands of new transformed 
vertices in rapid time. Stretching a texture on the 
UV points of those vertices, as we did with our 
tiles, gives us a sense of a Solid 3D object. 

A great feature of matrices is that we 
can combine - or ‘concatenate’ — them, by 
multiplying them in specific ways. So we can 
concatenate matrices and get the resulting matrix 
to produce the results of two, three, four, or more 
separate matrix multiplications. 

Our matrices mainly focus on translation, 
scaling, and rotation, and both our camera and 
model can have this. So, by multiplying a camera 
matrix containing its rotation and location 
(scaling isn’t really important to our camera yet) 
with our model’s matrix, we get a single matrix 
that transforms any vertex in our 3D space. 

There’s a tiny complication related to the fact 
we want to maintain a sense of perspective in 
our depth so that we can tell things are far away, 


because they will naturally appear to get smaller. 
This is also possible to represent in a matrix, 
called the ‘projection matrix’. 


Please, no more maths 

Now that’s not a full explanation of the maths - 
and it would take a lot more than four pages to 
really get into it - but as a simple explanation, 
we Simply need to know that we have to create 
matrices for each model, for one camera, and also 
keep a fairly consistent projection matrix. 

Once set up, we can feed our shaders with the 
model’s relative values, and the specific matrix 
for its position, and boom... we get 3D! 

Review the demo code, build and run it. At first, 
it all looks almost exactly the same. But press Q 
and A: these control a camera as it goes up and 
down in space, but keeping its gaze firmly on Bob. 

Code-wise, our code has not really changed 
much: we are still playing with a 2D map ina 2D 
space. We’re simply cheating a bit to visualise our 
tiles as cubes, and our sprites as a flat billboard 
which always faces the camera. 
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A Figure 1 Projection 
lets us visualise a 
world as a screen 


Don't type 
in models 


Although we have 
typed in cubes, 3D 
models can get 
very complex. It's 
much better to use 
a 3D modelling 
package for 
anything more 
than a cube. 
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A Figure 2 Our view of 
the world depends on 
from where we see it 


It’s acool effect and it shows how 3D is not a 
massive leap — we just have to become a little 
more comfortable with working with cubes and 
spheres, rather than squares and circles. 


Cleaning up the niggles 
However we display our images, we still need our 
logic to be tighter and smoother. We want to take 


M Even the most powerful processors get 
Dogged down by having to do too many 
Unnecessary things @ 


TopTip @ 


Start to 
think relative 


We still have a 2D 
map, but when 
we switch to full 
3D, the concepts 
of left, right, up, 
and down will 
lose much of 
their meaning. 


more care of how we hit walls and make our jumps 
a little less frustrating. It’s not really a massive 
change, just an acceptance that we may have to do 
more than one test. Our Bob sprite is bigger than 
a tile, so if we only test his top or bottom, or even 
his middle corners, we may miss other points 

of contact. 

Scanning a few points of contact makes sense, 
though, but only in the direction of travel. Take a 
look at the player’s movement code, and you will 
see we scan more carefully. 

But, notice that we don’t take quite so much 
care with our baddies? This is simple an economy 
of effort. We are going to place those baddies at 
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specific locations, so it’s logical to put them in 
places where we can comfortably predict the type 
of collision that will be most effective, in this case 
only testing their feet. 

If, however, we wanted them to be much more 
general and placed anywhere, then we could adapt 
Bob’s collision logic to work on them. There’s a 
golden rule in coding games: never do more than 
you need to. Processors are very fast and can doa 
lot of processing in a single frame, but even the 
most powerful processors get bogged down by 
having to do too many unnecessary things. So at 
all times, keep your code as simple as possible to 
achieve only the result you need. 


Multiple maps 
Having a more playable map in the new demo is 
ereat: it lets us see that our code works and it’s 
shaping into a nice game. But one map on its own 
is going to get boring, so let’s have multiple maps 
and let’s also have different sizes. 

Keeping track of the maps is a little tricky: 
we’ ve written most of our code referring totally to 
Map2 — in effect, our code is hard-wired to only 


use Map2. That’s not very effective; we need to be 
able to let our code use any map, at least a map 
that conforms to our definition of a map. 

By making the map a variable, it’s a simple job 
to plug in anew map, so long as they are all the 
same size. In fact, we can keep a whole range of 
them. It does get a bit more complex if you don’t 
know the size, but really if you have an unknown 
size of an array, we should really use the much 
more useful STD::vector structure, which is a 
dynamic array we can set to be any size we need. 


Next time 

Our very simple little game is complete, and 
although you may not realise it, you’ve used 
a number of basic concepts to make this work 


which are common in many game genres. In our 
next — and sadly final — article, we’ ll look back at 
these concepts and show you how to adapt them 
to work on almost any kind of game, and give tips 
on improving performance. Ul 


Learn more about C 


O== 
Brian has a whole book on the THE FUNDAMENTALS OF 
subject of making games C and aes *+ GAME TAME PROGRAMMING 


C++, called The Fundamentals of at 


C/C++ Game Programming: Using 
Target-based Development on 
SBCs. Grab it here: 
magpi.cc/nUkjEt 


TUTORIAL | Maghi 


TopTip @ 


Try to improve 
your maths 


Still a valid tip 

from last time: 
maths is the most 
scary thing in 
coding, but a small 
understanding can 
go a long way. 


Connecting Raspberry Pi 
to FPGA through USB 


CON-FMC™ supports Ubuntu, CentOS, and Raspbian. 
CON-FMC™ supports C/C++ API such as BfmRead() and BfmWrite(). 


CON-FMC™ supports USB 3.0/2.0. 


~“ 


~j. 


~— 


CON-FMC™ supports off-the-shelf FPGA board with FMC connector. 
CON-FMC™ supports FIFO interface and AMBA AXI/AHB/APB buses. 


CON-FMC™ supports CPU-to-FPGA offloading. 


For additional information contact at contact@future-ds.com or 
visit www.future-ds.com/CON-FMC 


FUTURE 


Design Systems 
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Add vision with the 


CAMERA 


The Pi Camera Module should be an essential piece of 
any digital maker's kit, as it can be used in a wide variety 
of projects. Wesley Archer puts us in the picture 


ive your Raspberry Pi the gift of sight with We’ve seen many exciting builds take advantage 
G a Pi Camera Module (magpi.cc/xSXqyL). of these, but being able to see what is happening 
This handy attachment connects directly around your Raspberry Pi is very simple with the 
to the Raspberry Pi and is used in a wide range of Pi Camera Module. These are some of the best 
vision-based projects. projects for beginners. They’re easy to set up and 
Using a Raspberry Pi to monitor its produce visible results. 
surroundings is a fascinating subject, especially Using the Camera Module is a great way to 
with the huge array of sensors, accessories, HATs, addan extra dimension to most projects. Let’s 
and pHATs available. get started... 


Reg ular or w Camera Module V2.1 w Camera Module NolR V2.1 


night vision? 


e 6 


a a 
va 


The Pi Camera Module has two 
variants - the standard version 
and the NolR version, which 
has the infrared filter removed 
to allow the camera to detect 
infrared light. It makes a great 
night-vision camera when used 
with an IR light source! 
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The Camera Module is small The small lens captures still 
enough to fit inside bird- images and video, which are 
boxes or small project boxes saved to the Raspberry Pi 
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SETUP YOUR ~ 
CAMERA MODUI 


Before you can start snapping away with the Camera Modt 


you ll need to connect it to the Raspberry Pi and test it out 


S 


You'll Need 


> Pi Camera 
Module 
magpi.cc/ 
kAtsHn 


> Pi Zero Camera 
Adapter (optional) 
magpi.cc/ 
uAUbdp 


> microSD card 


> Raspbian 


Disable LED 


The Vi Camera 
Module lights a 
red LED when 
activated (the V2 
Camera doesn't 
have one). To 
disable this, add 
disable _camera_ 
led=1 to the 
/boot/config.txt 
file (and reboot). 


> While small, the 
Camera Module takes 
high-resolution photos 
(up to 3280x2464 pixels) 
and captures HD video 
(up to 1080p) without 
breaking a sweat 


etting up a Camera Module couldn’t be 
easier. You attach the Camera Module 
directly to the Camera Serial Interface (CSI) 
port on the Raspberry Pi board. 

Connecting it to your Raspberry Pi is the same 
whether you own a Raspberry Pi 3+, a Pi Zero, or 
even an earlier Model B with 26 GPIO pins. 

However, if you are going to connect a Camera 
Module to a Pi Zero (1.3, W, or WH), you’ ll need 
to use a Pi Zero Camera Adapter. This is often 
sold separately (£4, magpi.cc/uAUbdp), and 
sometimes included with the Official Pi Zero 
case (magpi.cc/LECcmF). 

If you received a Pi Zero W free witha 
subscription to The MagPi (magpi.cc/subscribe), 
you will have got a Zero Camera Adapter cable free 
with your Pi Zero W and Starter Kit. 

Once you’ve got your Camera Module and 
Raspberry Pi, you use the cable to attach the two 
together. We’ll show you how... 


Connect the cable to 

a Raspberry Pi 2/3/73+ 
On a full-size Raspberry Pi, you will need to 
connect the camera cable to the Camera port 
nearest the Ethernet port. Gently lift the small 
plastic clasp on the Camera port and connect the 
camera cable with the blue part facing towards 
the Ethernet port, then gently push the clasp back 
down so it holds the cable in place. 


Connect the cable 

to a Pi Zero W 
The Pi Zero W has a smaller Camera port, but the 
official Pi Zero case usually includes the cable. 
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As with the full-size Raspberry Pi, gently pull 

the plastic clasp and then slot the camera cable 

in — you should see the white part facing upwards. 
You’ ll know if the cable is in correctly if the camera 
works, but it is best to check before booting your 
Raspberry Pi. 


Connect the 

Camera Module 
Similar to the way the camera cable connects to the 
Raspberry Pi, gently pull the small plastic clasp on 
the Camera Module and then slot the other end of 
the camera cable into the port — this time the blue 
part should be facing you, with the camera lens 
pointing the opposite direction. Gently close the 
clasp, locking the cable in place — the clasps can be 
fragile, so handle with care. 
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The cable connects 
the Camera Module to 
the Camera port on the 
Raspberry Pi board 


A Pi Zero owners will 
need a Pi Zero Camera 
Adapter to connect the 
Camera Module to the 


The cable is flexible, enabling you to position smaller Camera socket 
on the board 


and attach the Camera Module wherever you 
want for your project. You can also buy different- 
length cables to suit your project 


Enable the Camera Module Enabling via SSH Raspberry Pi 
By default, the Camera Module is not enabled If you are accessing your Raspberry Pi over Camera Case 
in Raspbian, but it is very easy to enable. If you SSH, you’1l need to enable the camera via the 
have your Raspberry Pi connected to a mouse, command-line Raspberry Pi configuration tool 22g) esas 
keyboard, and monitor, you can use the Raspberry instead. Enter the following in a Terminal window: AES eles le) ey 
; not buy a Raspberry 
Pi Desktop to enable the Camera function. Click pj 
i case designed to 
on the raspberry icon (top left) and choose sudo raspi-config Ep een ae te 
Preferences > Raspberry Pi Configuration. Click the Camera Module, 
Interfaces tab and set Camera to Enabled. Click OK; Now select ‘5 — Interfacing Options > P1 - Camera’ such as the PiShell? 
when prompted to reboot, click Yes. and choose <Yes> to enable the camera. Press 
—— = = ENTER on <Ok> and choose <Finish>. When 
— 
- » = asked to reboot, choose <Yes>. We’re now Set to 


snap away. 


Raspberry Pi Configuration - 


| 


System Interfaces | Performance | Localisation 
Camera ®) Enabled Disabled 
SSH *) Enabled Disabled 
R — as Test the Camera Module 
VNC Enabled *) Disabled 


Before diving into a project, it’s worth testing 
your Camera Module works as expected first. Open 
a Terminal and enter this command: 


Enabled Disabled 


Enabled ») Disabled 


Serial Port Enabled Disabled 


Serial Console 


raspistill -o /home/pi/hello. jpg 


1-Wire Enabled Disabled 


Remote GPIO 


Enabled *») Disabled 


a = Smile for a few seconds — you can see yourself on 


4 You must activate 


the live camera preview — while the photo is taken the Camera interface 
Lae Bs in Raspberry Pi 

and saved to the /home/pi directory. Why not open Pangan oa ceice 

it in File Manager to see the results? using the camera 
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You'll Need 


> Pi Camera 
Module 
magpi.cc/ 
kAtsHn 


> Pi Zero Camera 
Adapter (optional) 
magpi.cc/ 
uAUbdp 


> microSD card 


> Raspbian 


CAMERA MODUL 
SETTINGS | 


Get the most out of your Camera Module by tweaking 
the various settings and creating different effects 


he Camera Module doesn’t just snap photos 
— it also records video — but did you know 

that there are lots of different settings that 
can be applied to customise how the photo or video 
appears? In this guide, we’re going to explore some 
of the settings and commands that can be used 
to tailor how you use the Camera Module in your 
project, and we’ll explore some of the more quirky 
features too! 


1 Adjusting resolution 

and brightness 

The latest Camera Module has a maximum 
resolution for a photo of 3280x2464 pixels, but 
images this large can take up a lot of storage space 
over time and take longer to process by the Pi. 
Fortunately, raspistill, the program that captures 
photos on our Pi, allows us to specify the photo 
resolution very easily. For example, you can set the 
width (640 pixels) and height (480 pixels) using 
the -w and -h parameters accordingly. You can also 
specify the brightness with the -br parameter and 
a value between 0 and 100. The image above was 
taken with the NoIR Camera Module (hence the 
odd colours) using: 
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raspistill -w 640 -h 480 -br 40 -o /home/ 
pi/hello. jpg 


This demonstrates how you can take a smaller 
photo (640x480 pixels) with a brightness of 40, but 
feel free to experiment to see what works best. 


Pi Camera 12-10-2018 0950: 
Pa — 


2 Adding text 


If you’re old enough to remember actual 
printed photographs, then you may have noticed 
that some cameras added the date and time 
to record when the photo was taken. If you’re 
too young to remember, don’t worry as you’ve 
just learned something new! With raspistill 
you can add your own text to your photos too, 
using the -a or --annotate parameter. Take the 
following example: 


raspistill -a 4 -a "Pi Camera %d-%m-%Y 
*X" -o /home/pi/text. jpg 


The first -a 4 part sets the bitmask notation in 
the metadata to record the time (more info on that 
here: magpi.cc/2egcYup). 

The second -a part includes our custom text 
(Pi Camera) and formats the date into dd-mm-yy 
(%d-%m-%Y) before adding the time (%X) and then 
saving the photo the Raspberry Pi directory 
as text.jpg. 


Add image effects 

Another quirky feature of raspistill is that 
you can add image effects to photos taken by the 
Camera Module, such as inverting the colours toa 
negative, making the photo look like a sketch, or 
even adding a cartoon effect. Now, before you all 
get carried away, some of the effects can be a little 
hit-and-miss, but they can add a cool look to your 
photos nonetheless! This is done by adding the 


| oe. 


-ifx parameter along with the desired effect (full 
breakdown available here: magpi.cc/SuuECJ). 

The following example applies a negative effect 
to the photo, as well as adding our custom text, 
date, and time: 


raspistill -ifx negative -a 4 -a “Pi 
Pee rd nee ey: eee a a ay) ee : 
Camera %d-%m-%Y %X" ‘neg 


-O vA ho 


> 
2 
B 

P 


As you can see from the image above, this is an 
interesting effect! Be sure to try out the sketch and 
emboss commands too. 
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Camera 


Essentials 


We've only just 
scratched the 
surface of what 
the Camera 
Module can do 

in our guide, so 
why not take 

a look at The 
MagPi Essentials 
Camera Module 
Guide for amore 
comprehensive 
overview of all the 
commands, hints, 
and tips to ensure 
you get the most 
out of it? 


magpi.cc/ 
camera- 
essentials 


4 Make the photo 

look like a watercolour 
painting instead of a 
negative with the -ifx 
watercolour parameter 


4 Embossing is the 
process of creating a 
raised image, usually 
in paper or card. You 
can recreate the effect 
with the -ifx emboss 
parameter 
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CAMERA MODUL 
PROJECTS 


We've selected six Camera Module-related projects to try out. 
If you need some inspiration, then take a look at the pick of the 


Stop-motion animation 

Stop-motion animation — think Wallace & 
Gromit — is where a series of photographs are 
taken, but with minor changes made to the 
‘scene’ being filmed. The scene is changed 
slightly between shots — known as frames — 
and when they are all stitched back together 
afterwards, the illusion of animation is 
complete! In this fantastic tutorial, learn how to 
add a button to your Camera Module setup and 
create your very own stop-motion animation! 
More info: magpi.cc/KiYbdb 


Pi Zero LED case hack 

As you now know, the NoIR version of the 
Camera Module has the infrared filter removed 
from the lens so that it can detect infrared light. 
This makes it an ideal choice for projects in the 
dark. In this neat project, you can easily add IR 
LEDs to provide additional infrared light, so that 
your pictures capture more detail in the dark - 
and all housed within the official Raspberry Pi 
Zero case, too! 
More info: magpi.cc/xCozST 


Rodak: a Pi in a Kodak 

Taking photos is what the Camera Module is 
designed for, so what better way to do that than 
to upcycle an old Kodak Brownie Flash III camera 
to house a Raspberry Pi Zero, like Alex Ellis did? It 
also contains some additional components, such 
as a LiPo battery for power-on-the-go, a push- 
button to trigger the camera, and a cool NeoPixel 
status LED to show you when the camera is ready 
to fire again! 
More info: magpi.cc/sAxjyc 
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Google Vision: Camera Tell 

This cool project, by Dan Aldred (aka TeCoEd), 
makes use of the Google Vision cloud service. If you 
haven’t heard of Google Vision, it uses artificial 
intelligence to analyse an image and tells you 

what is in it! Dan takes this project even further by 
creating a portable camera — housed inside an old 
disposable camera — that uses a Camera Module, 

as well as Google Vision to announce what you have 
just taken a photo of. 


Outdoor Caomera 
Frame: @2 


Home CCTV with motionEye0S 

If you missed our Home Security feature in issue 
73 (magpi.cc/73), then you should definitely 
check out the handy motionEyeOS, which is 

a Standalone operating system that runs on 
Raspberry Pi and allows you to easily create your 
very own home CCTV setup with a few clicks. Once 
the OS image is flashed to your microSD card, you 
will be up and running in no time and be able to 
ae an oe on your home when you are away. 


More info: magpi.cc/mpL« jk 
qi i 


Make a parent detector 

Do you suspect your parents sneak into your 
room when you’re out? Do they play on your 
Xbox or PS4 without your permission? Then 
follow this tutorial and build a parent detector, 
using the Camera Module and a PIR (passive 
infrared) sensor, and catch them red-handed! 
Learn how the PIR sensor can trigger the Camera 
Module to take a photo whenever it detects 
movement, then see how your parents react 
when confronted ade me euilentce: 


FEATURE | Ma 
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Cube:Bit 


> Atronix » magpi.cc/PjJGgkp > From £22/$24 


Inspired by the Cubert project, this NeoPixel matrix can 
produce impressive 3D visual effects. Phil King sees the light 


oming in three main size options — 3x3*3, to the upper one’s DOUT, so those corners have 
C 4x4x4, and 5*5x5 — the Cube:Bit is a 3D alternating missing pillars as you build up. Even 
matrix of RGB NeoPixels. 4tronix tells so, the end result is a solid-feeling cube that you 
PIXELS: us that the product was inspired by Lorraine can carry around and even turn over in your hand 
125 NeoPixels Underwood’s Cubert project (magpi.cc/djMRkX), without any worries about it falling apart. 
(5x5x5 model) although the Cube: Bit is a whole lot smaller than 
DIMENSIONS: that giant creation. The 5x5x5 model (£90 / S98) Power and control 
89x89x89 mm we tested measures 89 mm along each side. While it’s possible to power and control the 
(5x5x5 model) First, however, you need to put it together, Cube: Bit manually — by connecting the metal 
as it comes in 2D square ‘slices’ (supplied in a stand-off ‘legs’ of the bottom slice toa5V 
areal posh-looking jewellery-style box). Assembly is power supply, ground, and Raspberry Pi or 
microibit quick and fairly simple, following the online guide microcontroller, using crocodile clips — it’s a 
connector, (magpi.cc/EujyXH). Each slice is mounted on the lot easier to simply mount it (using stand-offs) 
and others one below using the supplied metal stand-off on the optional Cube:Bit Base (£12 / $13). The 
pillars and screws. You just need to be careful to latter features four 5 V power connection options: 


flip each alternate slice (helpfully, they’re labelled =micro USB, 2.1mm DC jack, GVS pins, and crocodile 
A-side and B-side) and make surethe5V and GND clip positions. 

corners match, while the lower slice’s DOUT (data 
out) connects to the DIN on the one above. Only 
three pillars are used to connect each slice, since 
you don’t want to connect the lower slice’s DIN 


» The family of 
Cube:Bits, from 
3x33 to 5x5x5 
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This will in turn power a connected Raspberry 
Pi or other microcontroller. Along with a micro:bit 
slot, there’s a female GPIO header for Raspberry 
Pi. Note, however, that the nearby metal pillars 
prevent a full-size Pi model being mounted 
directly, so you’l] need to use a ribbon cable (or 
jumper wires to 5V, GND, and GPIO 18 — the only 
pins used). A Pi Zero, however, can be mounted 
directly on the Cube:Bit Base header, albeit with 
the Zero’s board sticking out of the side. 


Snaking pixels 

In essence, the Cube:Bit is a string of NeoPixels, so 
you can control them with any standard WS2812B 
compatible code. On the Pi, this necessitates 
installing the rpi_ws281x Python library — directly 
or by using the curl script for Pimoroni’s Unicorn 
HAT, for example. 


W Stack ‘em high! You can theoretically 
add as many extra slices as you want 


Since the ‘string’ of NeoPixels snakes up and A The multicoloured 
matrix produces some 


down each slice before connecting to the one dazzling displays 
above, this would make controlling them manually 
rather mind-boggling. Fortunately, 4tronix has 
created a Python library which can be downloaded 
with a one-line Terminal command. This maps the 
pixels logically so that you can easily address them 
with x, y, and z coordinates. So it might even bea 
useful aid for educators teaching 3D geometry. . 

At the time of writing, the Python library only Ve rd Ict 
came with a couple of code examples: test.py for 
a rainbow effect and individual pixel test, and 
purpleRain.py which sees purple ‘raindrops’ 
falling from the top to the bottom of the cube. The 
micro:bit has a larger range of MakeCode examples 
to show what Cube:Bit can do, including effects 
based on rotating the cube (possibly achievable 
using an Enviro pHAT or similar on the Pi). 

We also thought of using it as a fancy VU meter 
for music. Going one step further, Robin Newman 
has created a project with the Cube: Bit LEDs 
controlled from Sonic Pi using OSC messages 
(magpi.cc/RkxuDU) and even via a smartphone 
app. So there are plenty of possibilities. 


Easy to assemble, 
if not quite so 
simple to program, 
the Cube:Bit is 
pricey for the 
larger sizes - with 
the Base costing 
extra - but can 
produce some 
unique 3D visuals. 
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Raspberry Pi audio to another level, 

bringing digital signal processing 
(DSP) to a reasonably priced DAC (digital-to- 
analogue converter). 

Regular readers may notice that it bears a lot of 
similarity to the recent Beocreate board (reviewed 
in The MagPi #72, magpi.cc/72). The DAC+ DSP 
has much of the technology from the more 
expensive Beocreate (£149), but with only two 
RCA outputs (as opposed to the Beocreate’s four). 


Lt iFiBerry’s new DAC+ DSP hopes to take 


Wired for sound 
We found setup relatively straightforward. The 
board attaches directly to the GPIO pins of a 
Raspberry Pi 2/3 or Pi Zero, from which it draws 
its power. We tested it out with a Pi Zero W. 
OSMC works right out of the box and LibreELEC 
required a one-line tweak to the config.txt file. 
HiFiBerry hadn’t got the online documentation up 
during our review, but it has detailed setup guides 
for all its other products and we found following 
the regular DAC+ guide good enough to get going. 


76 | magpi.cc | DAC+ DSP 


DSP is where things get interesting. You can 
affect the digital audio output, adding your own 
customisations and effects with code. 

HiFiBerry has a GitHub repository with a 
range of software options for DSP boards 
(magpi.cc/bzizRQ). One interesting option is 


M You can affect the digital 
qudio output, adding your 
own customisations and 
effects with code @ 


to use REW (Room EQ Wizard, roomeqwizard.com) 
software to analyse the acoustics in your 
room (magpi.cc/xJaOiu). 
You can also set up a speaker crossover; 
this takes the single digital input signal and 
creates multiple output signals of high-, 
mid-, and low-range frequencies that can 
be tweaked (magpi.cc/gbvAXa). 


> HiFiBerry » magpi.cc/ENHNgK P £60/ S80 


ANALOGUE 


OUTPUT: 
2 x RCA 


DIGITAL I/O: 
Input up to 
96kHz, output 
up to 192kHz 


DSP: 
300MHz 


SAMPLE RATE 
CONVERSION: 


Asynchronous 
sample rate 
converter 


OTHER: 
EEPROM 


Upcycle old speakers and add smarts to 
gn analogue stereo with powertul digital 
signal processing. By Lucy Hattersley 


Verdict 


We like this board 
a lot. It offers all 
the joy of a high- 
end DAC with an 
additional layer 

of coding for 
digital audiophiles. 
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10 Best: 


Raspbelry Pl 
Starter Kits 


New to Raspberry Pi? Here are 
some essential beginner's kits... 


hen you first get a Raspberry Pi, there 
are always a few things you need to get 
to go with it. A microSD card, cables, 


W 


keyboards, electronics components, etc. With 
these starter kits, you can kick-start your learning 
with Raspberry Pi. 


Official 
Starter kit 


TYPE: Simple and clean 


This smart starter kit from Raspberry 


Pi includes a Raspberry Pi 3, as well 
as an official power supply, case, 
mouse, and keyboard. You even get 
Carrie Anne Philbin’s excellent book, 
Adventures in Raspberry Pi, to start 
your Pi journey with. 


> £119/S140 
> magpi.cc/DLrEkB 
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Raspberry Pi 3B+ 
essentials kit 


TYPE: Just the essentials 


This kit also comes with a Raspberry 


Pi, a slimmed-down Pibow case, a 
power supply, and a microSD card. 
The very essentials you'll need to 
get your Raspberry Pi running - 
along with a free Pi sticker. 


> £58 / S63 
> magpi.cc/PVrMLf 


Raspberry P13 B+ 
Starter Kit 


TYPE: A bigger kit 


This bigger starter kit from Pimoroni 
includes a keyboard, mouse, 
stickers, a Blinkt! light strip, and 

a getting started guide! It’s a nice 
beginner's kit that comes in a very 
pretty box, and those stickers are 
very important. 


> £90/S98 
> magpi.cc/TGNWLY 


Retro Gaming Kit 


TYPE: Retro fun 


A lot of people love to use their 
Raspberry Pi to play retro games on, 
and this kit is specifically designed 
to help you quickly make a great- 
looking Pi-powered console. The 
NES-style case is a nice touch. 


> £76/$102 
> magpi.cc/RmMLPCn 


Media Center Kit 


TYPE: Improve your TV 


As popular as retro gaming is on 
the Pi, home theatre PCs and media 
centres are even more popular 
among the community. This kit 
comes with all the essentials to get 
your HTPC Pi going, along witha 
lovely remote to control it all with. 


> £76/S102 
> magpi.cc/SUBydV 


GoP1Go3 


TYPE: Robot for beginners 


While not the cheapest robot kit 
around, we think this is one of the 


best robot starter kits, with plenty of 
resources to learn how to use robots 
available for it as well. You can then 
use the base to make bigger and 
better robots. 


> £76/S8100 
> magpi.cc/iGqLbs 


pi-top 


TYPE: All-in-one 


Quite an extreme concept of a 
starter kit, the pi-top is a laptop you 
build yourself that uses a Raspberry 
Pi at its core. You get power, a 
screen, a keyboard, and a mouse 
along with the Pi, and it's even gota 
chargeable battery so it’s portable. 
There's plenty of learning software 
on it as well! 


Pm £260 / $320 
> pi-top.com 


OOASMBOAR 
[teem Pay Crest ee 


pi-topCODER 


CEEDuniverse 


Raspberry Squid 
combo pack 


TYPE: A simple kit 


We really like this kit from Monk 
Makes as it’s a good introduction 


to electronics on the Raspberry Pi, 
which means it deserves a place 
on this list for people looking to get 
their start in using the (sometimes) 
mysterious GPIO pins on their Pi. 


> £10/S15 
> magpi.cc/LdhiFy 


The official 
Raspberry Pi 
Beginners Book 


TYPE: Kit and book 


This is not just a book full of 
excellent tutorials to get your 
started on your Pi journey- it’s 

also a Pi Zero kit! It comes with a Pi 
Zero W, adapter cables, a preloaded 
microSD card, and a case! 


Pm £25/ $33 
> magpi.cc/FeSHGb 
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Electronics 
Starter Kit 


TYPE: More electronics fun 


If you want to go beyond the 
Raspberry Squid, this kit opens up a 
whole world of basic electronics for 
you to experiment with. Each kit also 
comes with a load of quick projects 
printed on cards, with handy circuit 
diagrams to follow as well! 


> £13/$18 
> magpi.cc/BdmsoY 


@} RASPBERRY PI 


THE Official 
RASPBERRY PI 
BEGINNER'S BOOK 


65 RASPBERRY PI 
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The pocket-sized desktop computer! 


; li F 


FROM THE MAKERS OF MégPi THE OFFICIAL RASPBERRY PI MAGAZINE 


FREE RESOURCES 


There are loads of free tutorials on the Raspberry Pi 
website (rpf.io), along with all the free back issues of 
The MagPi on our site (magpi.cc), which you can use 
to learn everything you need to know about the Pi! 
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Learn Minecraft 


with Raspberry P1 


David Crookes looks at the resources that help you 
find your way ground this sandbox video game 


The MagPi team 


Price: 
£3.99 (Free download) 


magpi.cc/ 


minecraft-book It also lets you manipulate 


the structure using Python 
Scripts, opening up a host of 
potential hacks. 

For a solid grounding in 
such matters, this entry in 
The MagPi Essentials collection 
is a blockbuster. It helps to 


Minecraft takes on a life of its 
own with a Raspberry Pi, thanks 
to it coming with an API. This 
allows you to create mods that 
link the game to the real world. 


Hacking and Making in Minecraitt 


quickly build confidence, briefly 
introducing the basics of the 
game and how to get started 
before moving you straight 

into your first program and the 
fundamentals of the API. 

As well as understanding how 
to control and change any block, 
you’ ll learn how to code mini- 
games — including a fun two- 
player blast based on Nintendo’s 
Splatoon. The book also covers 
the terraforming process that 


Coding tutorials 


Understand how to program 
virtual worlds 


WOLFRAM 


E} WOLFRAM BLOG 


i Programming Minecraft on the Raspberry Pi 
The Randeed Raspbien softmare on the Raspberry Pi comes with a 
olerantaton yotrar . 


Marecra and 2 AUB ier 


Aerie 


30 rendering engine for the cutput of your code 


A Use Python or Wolfram Language to create things in Minecraft 


magpi.cc | Learn Minecraft with Raspberry Pi 


HOW TO PROGRAM MINECRAFT 
ON A RASPBERRY PI 

This tutorial explores Minecraft: Pi 
Edition’s sole playing mode - Classic 
- and encourages you to write a 
‘Hello World’ program that can be 
adapted to transport Steve around 
the world. 

> magpi.cc/tUJpeB 


PROGRAMMING MINECRAFT 
WITH WOLFRAM LANGUAGE 
With this tutorial from the Wolfram 
blog, you can learn how to combine 


Ua i 


HACKING inp 
MAKING 


™MINECRAFT 
CODE VIRTUAL WORLDS 


on Haspberry Pj 


lets you create an entire world 
from a favourite block and the 
ability to play God by sparking 
a host of natural disasters. 
More than that, you’ ll be 
taught ways of making use of a 
Sense HAT, the GPIO pins, Sonic 
Pi, and JavaScript, all clearly 
and concisely explained. To aid 
your learning, there’s a handy 
reference guide and annotated 
diagrams at the right moments. 
It’s sure to level you up fast. Hl 


Minecraft and the Wolfram 
Language to create in-game 
structures that you can then look at 
from the air. 

> magpi.cc/CTMkgz 


BUILD A HOUSE IN MINECRAFT 
USING PYTHON 

This tutorial, taken from issue 68 of 
this very magazine, explains how you 
can design and build a house using 
Python. It comes with links to the 
project's complete code. 

> magpi.cc/xQwLLb 
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Octting Started with Minecraft Pi 


Getting started YouTube 


with Minecraft 


Videos 


Learn tricks via short 


Raspberry Pi Don’t worry if you’re an absolute 
Foundation Minecraft newbie, because this video courses 
well-explained online resource 
he certainly has you covered. It GETTING STARTED 
ree 


magpi.cc/DgJMOe 


leads you by the hand to ensure 
that your first steps in the 
game are as painless as possible 
and, by splitting the guide over 
nine approachable sections, 
each lesson has the right 
amount of information without 
feeling overwhelming. 

The first four tutorials 
concentrate on installing the 
game and explaining the basics 
of gameplay. The next four 


Minecraft quick-start 
guide and wikl1 


plunge you into the Python 
programming interface where 
each command and block of 
code is helpfully highlighted 
and breezily explained. 

We like that it avoids 
overcomplicating matters and 
that results are seen on-screen 
at every step. Ending with 
tips on how you can use your 
knowledge, it’s sure to whet 
your appetite for more. H] 


CODING MINECRAFT PI 
Carrie Anne Philbin's gentle 
and informative introduction 
to hacking Minecraft using 
Python is delightfully easy to 
follow thanks to an exhaustive 
approach that explains and 
shows each step in detail. 

> magpi.cc/zvXssK 


MINECRAFT PI EDITION 

- SURVIVAL MODE & 
PYTHON SCRIPTS 
Although poorly presented 
and spending large chunks 

in silence, this inspiring video 
is nevertheless educational, 
covering a Survival Mode mod 
while linking to Python scripts 
and assets in the description. 
> magpi.cc/dsMPqC 


Raspberry Pi Visit the official Minecraft The former shows you the 
Foundation website and, as well as being hardware and software needed 

able to download a free copy of to get Minecraft Pi up and HACKING MINECRAFT 
dies the game, you can access the running. The latter, however, P| EDITION 


magpi.cc/ VUUMpL 
magpi.cc/qEzamd 


MINELRAF Y 
s errr 


Raspberry Pi quick-start guide 
and Minecraft wiki. 


Where the tech 
world meets 


Pi Edition 
w This page describes coment that is ne lenger in the game. 
This version of Ldineeralt is no longer updeted 


Mivecraft Pi Edition 5 3 veruon of re 13° Gervetoped for the Kacpherr) 


wes Geveloped Dy Aron hoerminen and Det F ripe * 


READ MORE > 


Contents Poe! 
neegeneer 


G@GAMEPEDIAT 


& The Edit wikis and earn 
Gamepedia PRO and an 
ad-free experience! 


Mnecret: Pi Cdition was originally announced on the Mojang website on November 24. 2012 !”) 

There was a compiled build mbeles ©. 1 on the Mojang sepostery, albeit encrypted untl he pame's launch in February 2013, 
making t raccesshie When £ was fret uploaded however, it was unprotected for 3 thort amaurt of tre alinaing for the 
demamionad cf tun emcee beebewe fie trae retmarse Con Senemeniaes 25 3019 Menerws peinaned a ret cm tele elf alte awnenaeirs tue 


is a mine of information and 
one to bookmark for future use, 
particularly so for the handful 
of references at the end and, 
crucially, the details listed 
under Gameplay. 

Here you can find out how 
each block, tool, and plant 
works within the game, along 
with items that only work if 
modded. You can also discover 
any limitations, both within 
the elements themselves and 
the Pi version of Minecraft. 
Fully editable and expandable, 
it should go some way to 
answering your questions. H] 


Superbly fronted with dollops 
of humour, this extremely 
approachable guide explores 
Python coding and the basics 
of the Minecraft API, with lots 
of nods to extra resources and 


further information. 


> magpi.cc/dhuRid 
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DIY Games 
Console 


seid ae 


LNELAIS AT SEAL OD 


200 pages of 


THE THE Official =N 
RASPBERRY PI 


PROJECTS BOOK 


ee WMOLUMES4 


Amazing hacking and making projects 
from the makers of MagPi magazine 


Inside: 
@® How to get involved with the Pi community 
@® The most inspirational community projects 
® Essential tutorials, guides, and ideas 


@ Expert reviews and buying advice 


ai le @ 
Cp magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


# Available on the ; GET IT ON 


@ AppStore P> Google Play 
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~ The first Astro Pi mission 
involved ESA Astronaut 
Tim Peake 


Image Credit: ESA (European Space Agency) 


84 | magpicc | Dave Honess 


Honess 


Taking education to the stars with Space Dave 


> Category Educator | >» Website www.esa.int 


> Day job 
4 y M y earliest memory 
of being interested 
in Space was 
watching Halley’s Comet 
as a nine-year-old,” Dave 
Honess tells us. We know Dave 
personally — he used to work at 
the Raspberry Pi Foundation as 
the man behind Astro Pi, and 
he’s even written a couple of 
tutorials in the magazine. 
These days, Dave works with 
the European Space Agency 
(ESA) to help organise their 


educational programs, and 
liaises with current Astro Pi 
programs at the Foundation. 
“Most of my career had 
nothing to do with space,” Dave 
admits. “But I always maintained 
an interest and enjoyed watching 
the ISS live streams in the early 
noughties when it was still being 
built. I never even imagined 
that the space industry could be 
a place where I might work one 
day; it always seemed So distant 
and abstract.” 


ISS and International Education Operations Coordinator 


Dave started working for 
the Raspberry Pi Foundation 
in early 2014, and soon found 
himself talking to folks 
from the UK Space Agency 
about a collaboration that 
eventually became the first 
Astro Pi mission. 

“A friend working at ESA in 
the Netherlands told me he 
was changing jobs and that his 
position was going to become 
vacant.” Dave said. “We spent 
about an hour on the phone 


INTERVIEW | Mag?i 


& Astro Pi 


Hopefully you know by now 
that there are two special 
Raspberry Pi boards up on 
the International Space Station. Named Ed and Izzy, these two 
Astro Pi devices are designed to perform different kinds of 
experiments on the ISS: Ed lives in the Columbus module and 
uses a normal Camera Module, while Izzy has an IR Camera 
Module that looks out of a porthole down onto Earth. 

There are regular competitions for European schoolchildren 
to get their experiments run on these computers, with a couple 


discussing all aspects of the work 
and... I decided to apply for the 
job. We have now moved to the 
Netherlands, and I have been 
working at ESA ESTEC [European 
Space Research and Technology 
Centre] since March 2018.” 


What’s your favourite memory 
of working in the intersection 
of space and education? 


“Tt’s hard to pick just one. ’m 
really grateful to my former 
colleagues at the Raspberry Pi 
Foundation for allowing me to 
travel to Florida to watch the 
OA-4 rocket launch at Kennedy 


V This is Izzy the Astro Pi - 
its camera looks out of a 
window of the ISS 


own Astro Pi case here: 
magpi.cc/EtDxAo 


Space Center in 2015 (the one 
carrying the original Astro Pi 
hardware to the ISS). I have 
strong memories of talking to 
the kids that have participated 
in Astro Pi, and hearing them 
say they now want to study 
aeronautics or astrophysics 
and suchlike.” 


Do you have any personal 
space-related plans? 


“T do, actually. Every year, ESA 
organises a Staff trip to French 
Guiana to see the Ariane launch 
facility; you have to fund the 
flights yourself, but you’ ll get 
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A Find out how to print your 


access to the launch site and 

a guided tour. If you’re lucky, 
you also get to see an integrated 
launch vehicle sitting on the 
pad, and if you’re really lucky 
your visit might coincide with 
an actual launch.” 


Any future work-related plans 
you can share with us? 


“T’m actually starting to believe 
that computing education is 
getting to a really good place 
now, not to say that we should 
take our foot off the pedal or 
anything. Astro Pi has developed 
into a mature educational 
challenge and I think it will go 
from strength to strength. I’m 
now turning my attention a little 
towards amateur radio, which 

is something that definitely 


doesn’t have the uptake it needs. 


Radio remains the only way 

to communicate with all our 
spacecraft throughout the solar 
system, and organisations like 
ARISS and local HAM radio clubs 
are, in my opinion, becoming 
more and more necessary to 
attract new talent. It would be 
good to see educational material 
joining computing and radio 
topics. After all, all spacecraft 
can be boiled down to two 

main components: a computer 
and aradio!” 


even running right now! Head to astro-pi.org for more details. 
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Makers galore at the annual 
World Maker Faire! 


ast year you may remember that we went out 

with the Raspberry Pi Foundation to help out 

at their stall, getting young makers started 
with their maker journey through some fun Pi 
projects.While there was no official Raspberry Pi 
stall at World Maker Faire this year, that doesn’t 
mean there weren’t plenty of amazing makers 
there, and many of them were using a Raspberry Pi 
in their projects. Take a look! 


There were talks galore 


Do not feed this 
Seymour puppet 


Amazing 3D prints 


Some of the robots 
were very big 


This mini Landspeeder 
is perfect for popping 
down to Tosche Station 


Raspberry Pi didn't 
have a booth, but 
team members were 
still present . Credit: Lenore Edman 
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Credit: Lenore Edman 


World Maker Faire New York 2018 | magpi.cc | 87 


SS agri | THIS MONTH IN RASPBERRY PI 


Announcing the ™ 
Raspberry Jam Big 
Birthday Weekend 2019! 


Celebrate the birthday of Raspberry Pi at your local Jam! 


6 y 
Foundation coordinated over 100 community- 


or Raspberry Pi’s birthday this year, the y 4 e 
F led Raspberry Jam events around the globe. In % R A S - = E PR cr Y 
a few months’ time, Raspberry Pi will be seven years 
old — and to celebrate, they’re hosting another Big 
Birthday Weekend, which takes place all over the 7 . 
world on 2-3 March 2019. 

“Last year’s event was a lot of fun!” Ben Nuttall, 
Raspberry Pi Community Manager, wrote on the 
Raspberry Pi blog. “We sent out starter kits and 
extra birthday goodies to participating Jams, and 
even put together a tweeting Raspberry Pi photo- 
booth for people to set up to share their events.” 

With the incredible support of the Raspberry 
Pi community, the Pi’s birthday was able to be 
celebrated in 40 countries, covering six continents — 
that is, every continent except Antarctica! Members 
of the Raspberry Pi Foundation team joined in with 
events in the UK, in California, across Europe, and 
elsewhere, despite unexpected UK snow-storms. 


Get involved 
If you'd like to run an event for our Big Birthday 
Weekend, please head over to the Big Birthday 
Weekend 2019 page (magpi.cc/CrMUru) and sign 
up for the newsletter. That’s where updates will be 
provided on what’s going on and what you need to 
do to join in. 

If this sounds like it might be your kind of thing, 
but you’ve never done it before, there’s plenty 
of time to get off to a gentle start and run a Jam 
before 2018 is out. When you join the newsletter, 
an invitation will be sent to you for the Jam maker 
Slack community, where you can get support from 
the Raspberry Pi Foundation and from wonderful 
Jam makers all around the world. They have lots of 
help and advice to offer people who are just starting 
out with their first Jam, and you’1l be well rehearsed 
by the time the Birthday Weekend comes around. Hl 


Not sure where to start 
running your own Jam? A 
handy free guidebook all 
about setting up a Raspberry 
Jam can get you started. 
Head here to grab the PDF: 
magpi.cc/2qQgDHfQ 


GUIDEBOOK 
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So 
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P} projects you Yyy 
can crowdfund this month Vy 


CROWDFUNDING 
A PI PROJECT? 
If you've launched an 


irresistible Pi-related 
project, let us know! 


magpi@raspberrypi.org 


ITX & Raspberry Pi Retro 
~nuessclmadsias Keyboard Computer Case 


“This is not a kit, it is a fully assembled professional 


tablet for industrial and field use,” states the We love seeing these sort of projects that create very 
Kickstarter page for the HackerTab Pro. It's a Compute retro-style cases for the Pi. The FUZE also does a 
Module 3-powered tablet that you'll be able to buy for similar thing, bringing the look of the BBC Micro to the 
€249 (£219/$287) and the makers reckon you'll be able Raspberry Pi. It's very apt, as the Pi was inspired by the 

to use it in industrial settings, as well as for retro gaming Micro. This project is made out of PVC and comes as a kit 
or an in-car computer. It looks pretty snazzy, too. that you can build yourself, or a more complete package. 


>» kcek.st/2pCngHr > magpi.cc/iTpMgJ 


Best of the rest! tere are some other great things we saw this month 


RASPBERRY PI ETCH ASKETCH | ROTATING VIDEO SCREEN 


This is extremely fun - motors controlled The Pi doesn't have a built-in gyroscope, 
by a Raspberry Pi turn the knobs on an so, unlike a smartphone, you can't tilt it to 
Etch A Sketch classic toy. With a bit of change the orientation of a mounted mini 
hacking and programming, maker Sunny display. This project takes the concept 
Balasubramanian managed to get the and goes a step further, with video that is 
Pi to break down images sent to it into constantly playing at a specific orientation 
instructions to draw it on the toy. as you move the Pi around. It’s magic. 


> magpi.cc/wuLzXa > magpi.cc/HrwPdB 


| SMARTER MIRROR 


It takes something a bit different to 
get us to pay attention to a new magic 
mirror: there are so many of them! 
However, this build - which includes 
useful hooks for storing keys, anda 
charging station - makes it a lot more 
useful than others! 


> magpi.cc/tZDPyp 
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s 


Raspberry Jam 
Event Calendar | 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. MaltaPi 


® Saturday 3 November 

& Vintage Computer Club Malta, Triq il-Fikus, Malta 
> magpi.cc/pTtuXwW 

This weekend-long event is free and accessible, 

with room to show off your own projects. 


02. STEM Raspberry Pi for kids 

® Saturday 3 November 

© Silver Spring Library, Silver Spring, MD, USA 
> magpi.cc/CKhMOq 

For folks living in Maryland and Washington DC, 
there will be several STEM classes related to Pi. 


03. Pi and More 

® Saturday 3 November 

9 Universitat Trier, Trier, Germany 

> piandmore.de 

Beginners and experts meet in a relaxed atmosphere 
for talks, workshops, and projects focusing on Pi. 


04. Thorpe Raspberry Jam 

® Saturday 3 November 

9 Thorpe St Andrew School, Thorpe St Andrew, UK 
> magpi.cc/jTCeuUi 

Thorpe Jam is back, with show-and-tells, 

electronics workshops, and more. 
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05. Raspberry Pi Club Los Alamos 

® Thursday 1 November 

@ Los Alamos Makers, Los Alamos, NM, USA 
> magpi.cc/DrSTtT 

A weekly club for people interested in the Raspberry Pi, 
where everyone is welcome. 


od 


06. Leeds Raspberry Jam 

® Wednesday 7 November 

Y Dixons Unity Academy, Leeds, UK 

> magpi.cc/abNdVn 

Get hands-on with more digital making activities through 
the workshop, and a hackspace area to share projects. 


07. Raspberry Jam Cambridge 7 
FULL CALENDAR 


Get a full list of upcoming 
events for October and 
beyond here: 


® Saturday 10 November 

Y Sancton Wood School, Cambridge, UK 

> magpi.cc/mXsjmA 

A great way to meet others and learn something 
new. Sessions are classroom based and run hourly. rpf.io/jam 
\ 
08. Raspberry Jam @ Pi Towers 

® Saturday 10 November 

9 37 Hills Road, Cambridge, UK 

> magpi.cc/HDikif 

Visit the new Raspberry Pi offices for the 

November Raspberry Jam @ Pi Towers! 


EVENTS | Magi 


sd FIND OUT 
ABOUT JAMS 


Want a Raspberry Jam 
in your area? 
Want to start one? 


Email Ben Nuttall about it: 


OS jam@raspberrypi.org 


We've highlighted some of the areas & 
in need of gd Jam! Can you help out? 


Raspberry Jam advice: 


Fundraising 


W tin. Then we pull winning “ey @ 


cs 38 Poh oie 
tickets from a box and they win a prize we’ve 4 “a > 
had donated, like a HAT or something.” i ~ 


e hand out free raffle tickets 


Andrew Oakley - Cotswold Jam 


e? 

“e RASPBERRY & 
Every Raspberry Jam is entitled to apply fora NING 
Jam starter kit, which includes magazine issues, we LDS 
printed worksheets, stickers, flyers and more. 


Get the book here: magpi.cc/2q9DHfQ 
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Your 
Letters 


I really loved the ‘build a laptop’ 
article from the October issue 
and was hoping to get started on 
it, or something similar. I just 
wanted to know if I’d be able 


to use a Raspberry Pi 3 instead 
of a Raspberry Pi Zero? I havea 
Pi 3 spare and as it’s a bit more 
powerful, I thought it might be 
better to use that! 


WY The laptop build last 
issue uses a Pi Zero, 
but you can use a Pi 3 
if you want to 


Paul vic email 


The particular build in issue 74 of 
The MagPi uses a Pi Zero to make 
sure it’s as small as possible 
— however, there’s nothing 
stopping you using your Pi 3 
and a different 3D-printed 
case! A lot of the parts, 
build tips, and software 
instructions will be similar, 
as you Still need to have it 
powered by a battery and use 
wireless input devices. 
Check out the section on 
upcycling laptops as well, as that 
may be very relevant to you! H 


Contact us! 


> Twitter §©@TheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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I’m a 70-year-old total newbie 
to Pi and its projects, many of 
which I find fascinating. I do 
have a question, though. In 
The MagPi issue 74 ‘Raspberry 
Pi on x86 laptops’, under the 
heading ‘Burn and boot’, 

there is what looks like a link 
(magpi.cc/2joTqNm). 

I have tried many times to 
access this link for further info 
and am unable to? Please tell an 
old duffer what he needs to do. 


newbie70 from the forum 


This one of the ‘shortlinks’ that 
we’ ve posted in the magazine, 
usually to make typing in the 
(otherwise longer) links a bit 
easier. You just need to copy 
them into your browser. If you’re 
having problems, make sure to 
re-read the link and check to see 
if you’re using the correct letters. 
If all else fails, all the links 
in The MagPi are clickable in the 
PDF version, so just load up the 
free PDF and click on it from 
in there. 


P Send us 
your scary 
builds 


Highlighted Spooky projects 


I enjoyed reading about 

the Halloween projects last 
issue! Will you be doing 

any highlights of reader 
projects at all this year? 

I have one that I might be 
able to send you if so, and 

I think there are a few others 
I could definitely point 
towards you... 


Derek vig email 


We'd love to do a bit ofa 
community Halloween project 
roundup this year, like we 
did last year! Issue 75 went to 
print a little too early for us 
to do it in time for Halloween, 
but check back in issue 76 
and we’|I definitely try to find 
some of the most petrifying Pi 
projects that are out there. 
Otherwise, you can always 
send them to the email 
address and other contact 
info above! H 


I had a lot of fun at the 
birthday Jams and Raspberry 
Fields last year. Is there any 
info yet on if you’ll be doing 
anything like that again: 


Stephanie on Twitter 


Good timing — we’ve got info 
about Big Birthday Weekend 
2019 in the This Month in 
Raspberry Pi section. It’s a 
Similar deal to this year: Jams 


Raspberry Pi is bringing back the Big 
Birthday Weekend again next year 


around the world will celebrate 
the Raspberry Pi’s birthday in 
coordinated Jams. Hopefully 
none of them will be snowed off 
next year! 

As for Fields, we don’t have 
any news about that yet. We 
feel like the events team is still 
recovering from the one in the 
summer! We’ll let you know 
as soon as we can if there are 
plans for another one! 
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High Performance Audio For Raspberry Pi 


HAT modules 
no soldering 
needed 


Most sold Digital-to-Analog converter 
192khz/24bit offers high end sound quality 
also availabe as DAC+ light, DAC+ pro and DAC+ DSP 


What to built with HiFiBerry soundcards? 


visit hifiberry.com for complete product range, guides and inspirations 


Code Club is a network of volunteers and  S=€§ 
educators who run free coding clubs for 
young people aged 9-13. 


Were always looking for people with coding skills to volunteer to 
run a club at their local school, library, or community centre. 


You can team up with friends or colleagues, you will be supported 
by someone from the venue, and we provide all the materials 
youll need to help children get excited about digital making. 


MagPi 
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Picade retro 
gaming consoles! 


We loved the new Picade in issue 74 of The MagPi 
(magpi.cc/74). With an authentic arcade controls and 
an eighties look straight from your nostalgia, It’s the 
perfect retro gaming device for your home. 


Pimoroni has given us a Picade and 
Picade Console to give away, so enter | In association with 


today for your chance to win one! [> |/ O IR OC) N 


Enter now at: magpi.cc/ | Learn more: magpi. 


Terms & Conditions 


Competition opens on 24 October 2018 and closes on 29 November 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 


Win one of two Picade retro gaming consoles magpi.cc 95 


L 


CoderDoje 


Can you 


people to become 


CoderDojo is a global network of free, volunteer-led, 


| ne | | project-based programming clubs for young people aged 
amma y 7-17. Here they can learn to code, build a website, create 
NN —_ d an app or a game, and explore technology in an informal, 


creative, and social environment. 


In order to run locally we need volunteers like you with 
a wide range of skills. You don’t have to be a coder to 
mentor. Dojos benefit from a mix of mentors providing 
support and encouragement to CoderDojo attendees. 


> 4 
17 = 


Join us at coderdojo.com/volunteer 


on ST 


The CoderDojo Foundation its Irish Registered Charity (524255) CHY20812 R Bera D i 
and Is part of the Raspberry Pi Foundation, UK registered charity 1129409 Part of aspberry Fl 
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Plus! 


Smart 
Lights 


Control home 
lighting with 
Raspberry Pi 
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HERO GUIDE 


DONT MISS OUT! 
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TWITTER @TheMagPi 
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Making magazines 


Eben Upton on building physical products 


nce, | thought running a 
0) hardware company would be 
all about making hardware. 
Turns out, it’s actually about learning 
new things. 

When we started back in 2006, I 
was an embedded software engineer: 
I knew how to crank out high- 
performance C and assembler for 
mobile phones, games consoles, 
and microcontrollers, but absolutely 
nothing about how to design chips or 
PCBs, still less how to build millions 
of units of a physical product and get 
them to customers all over the world. 

Still, it?s amazing what you can pick 
up if you hang out with bright people. 


Once upon atime 
Around the time I was building the 
first Raspberry Pi prototype (on 
Veroboard!) in 2006, I joined Broadcom 
as a software engineer in the video and 
eraphics team, and got my first taste 
of hardware design. Although I was 
supposed to stick to writing firmware, 
every software engineer had access to 
the Verilog source code for the chip 
that we were working on. Nobody in 
their right mind would let me write 
a module from scratch, but if I could 
find a bug, and get my fix signed off 
by the real hardware engineer in the 
next cubicle (future Raspberry Pi COO 
James Adams), my code might make it 
into the chip. 

A couple of years later, we started 
work on the first real Raspberry Pi 
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design. There’s a vast difference 
between soldering down some PDIP 
chips on a piece of Veroboard, with 
signals running at a few tens of 
megahertz, and escaping high-speed 
signals like HDMI from a fine-pitch 
BGA on a six-layer PCB. But I got 

to watch over my co-founder Pete 
Lomas’s shoulder while he laid 


do this, and equally insistent that 
we should recruit Russell Barnes as 
editor. After five digital-only issues, 
the magazine made a triumphant 
return to print in August 2015, and 
has never looked back. Russell has 
surrounded himself with an amazing 
team, including Lucy and Rob here 
at The MagPi, and Ben and Andrew 


M | spend a wholly ingppropriate gmount of time 
thinking about our publishing business @ 


out what would become the classic 
Raspberry Pi Model B. And six 
months later, I got to watch Mike 
Buffham (future Raspberry Pi Director 
of Product Management) figure 

out how to build Pete’s design in 
volume at Sony. 

Ill never be able to write Verilog 
like James, lay out a PCB like Pete, 
or juggle a supply chain like Mike. 
But hanging out with them taught 
me more about hardware, and 
about business, than any course 
or textbook could. 


Going to print 

Which brings me to publishing. At the 
Start of 2015, we had the opportunity 
to take up the reins of The MagPi 

from Ash, Will, Ian, and Aaron, who 
had been running it since 2012. Liz 
was quite insistent that we should 


at HackSpace, and together they’ve 
done amazing things. 

I spend a wholly inappropriate 
amount of time thinking about our 
publishing business. In part, that’s 
because it’s further from my comfort 
zone than anything else we do: 
there’s just so much for me to learn 
here. But it’s also because even I can 
see the scale of the opportunity ahead 
of us. I think you’re going to love 
what the team has planned over the 
next couple of years, but for now let’s 
raise a glass to the first 75 issues of 
The MagPi, and to the next 75. Hl 


Eben Upton 


Eben is the creator of Raspberry Pi and a 
co-founder of the Raspberry Pi Foundation. 
He has extraordinary travel booking skills. 
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THE Official 
RASPBERRY PI 
EGINNERS BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 
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The pocket-sized desktop computer! ___— 
) PI ZERO 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 


Make simple electronic circuits 


Raspberry Pi board and case 
Power supply and HDMI Cable 
Pre-Programmed Memory Ca d 
Over 40 electronic Parts 
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DUMM. A Wiley Brand 
Available in Europe 


Available for worldwide shipping at: through RS Components 


$89” £69°° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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